From 4526cc48336f1ac1d90011ab82d9f4e9553fada2 Mon Sep 17 00:00:00 2001 From: maliming Date: Wed, 24 Sep 2025 09:24:45 +0800 Subject: [PATCH] Document cache error hiding behavior in development --- docs/en/framework/fundamentals/caching.md | 3 +-- docs/en/release-info/migration-guides/abp-10-0.md | 7 +++++++ 2 files changed, 8 insertions(+), 2 deletions(-) diff --git a/docs/en/framework/fundamentals/caching.md b/docs/en/framework/fundamentals/caching.md index c1a720b394..75dab91543 100644 --- a/docs/en/framework/fundamentals/caching.md +++ b/docs/en/framework/fundamentals/caching.md @@ -224,9 +224,8 @@ Configure(options => > Write that code inside the `ConfigureServices` method of your [module class](../architecture/modularity/basics.md). -#### Available Options -* `HideErrors` (`bool`, default: `true`): Enables/disables hiding the errors on writing/reading values from the cache server. +* `HideErrors` (`bool`, default: `true`): Enables or disables hiding errors when reading from or writing to the cache server. In the **development** environment, this option is **disabled** to help developers detect and fix any cache server issues. * `KeyPrefix` (`string`, default: `null`): If your cache server is shared by multiple applications, you can set a prefix for the cache keys for your application. In this case, different applications can not overwrite each other's cache items. * `GlobalCacheEntryOptions` (`DistributedCacheEntryOptions`): Used to set default distributed cache options (like `AbsoluteExpiration` and `SlidingExpiration`) used when you don't specify the options while saving cache items. The default value uses the `SlidingExpiration` as 20 minutes. diff --git a/docs/en/release-info/migration-guides/abp-10-0.md b/docs/en/release-info/migration-guides/abp-10-0.md index 4fa4fefe6a..e7afdce02e 100644 --- a/docs/en/release-info/migration-guides/abp-10-0.md +++ b/docs/en/release-info/migration-guides/abp-10-0.md @@ -75,5 +75,12 @@ We added a failure retry policy to `AbpEventBusBoxesOptions` (see `InboxProcesso See the [Add failure retry policy to InboxProcessor](https://github.com/abpframework/abp/pull/23563) PR for more information. +### Disable Cache Error Hiding in Development Environment + +Starting from **ABP 10.0**, the [`HideErrors`](../../framework/fundamentals/caching#Available-Options) option of `AbpDistributedCacheOptions` is **disabled by default in the development environment**. + +By default, ABP hides and logs cache server errors to keep the application running even when the cache is unavailable. +However, in the **development environment**, errors are no longer hidden so that developers can immediately detect and fix **any cache server issues** (such as connection, configuration, or runtime errors). + ## PRO