问题描述
APIM支持cache-lookup-value策略，它的 caching-type 可以设置为：
- internal，表示可使用内置的 API 管理缓存；
- external 使用外部缓存，如Azure Redis及其它Redis服务
- prefer-external 如果外部缓存已配置，则使用外部缓存，否则使用内部缓存。
但是，在自建网关(self-hosted gateway)中，却无法使用internal 内置缓存，详见：https://docs.azure.cn/zh-cn/api-management/caching-overview#caching-service-options
但是，在使用 APIM Self-hosted Gateway 访问 External Redis Cache 时，还是无法读取缓存值。
这是什么原因呢？
问题解答
根据从APIM Self-hosted Gateway中获取到的日志，可以发现CacheEventIgnoredDueToRegionMismatch报错。
Info 2026-01-4T09:48:34.330 CacheEventIgnoredDueToRegionMismatch, message: expected: aaaa-xxxxxxxx, actual: bbbb-xxxxxxxx. Configured use from location: bbbb-xxxxxxxx, source: ConfigurationBasedCacheResolver
以上的日志表示 表示 self-hosted gateway 配置的 location 与 External Cache 支持的 location 不一致。
这就是导致缓存策略<cache-lookup-value>无法命中外部 Redis 无法被使用的根因。
解决方法
- 确保 APIM self-hosted gateway 的 location 与 External Cache 支持的 location 完全一致
- 若 external cache 设置了特定 region，则 gateway 必须配置同样的 region。
- 若 external cache 设置为 `default`（支持所有 region），则不会产生限制。
- 可在 APIM Portal 中执行以下步骤验证：
- 检查 External Cache 的 location 配置
- 对比 self-hosted gateway 在 YAML 或运行环境中设定的 `location` 或 `region` 字段
- 修正为一致即可恢复缓存能力
参考资料
APIM 缓存概述：https://docs.azure.cn/zh-cn/api-management/caching-overview#caching-service-options
APIM 策略从缓存中获取值：https://docs.azure.cn/zh-cn/api-management/cache-lookup-value-policy
当在复杂的环境中面临问题，格物之道需：浊而静之徐清，安以动之徐生。 云中，恰是如此!