如何查看Azure App Service中Microsoft.Extensions.Caching.Memory的内存缓存数据
核心问题解答
1. Azure门户是否提供内存缓存查看工具?
不提供。Microsoft.Extensions.Caching.Memory属于进程内私有内存缓存,所有数据都存储在你的.NET应用进程的私有内存空间中,没有对外暴露的访问接口,和独立部署的Redis服务完全不同,因此Azure平台侧无法直接读取应用进程内部的缓存数据,没有类似Redis控制台的官方工具。
2. 缓存取值始终为null的常见原因
- 多实例路由问题:如果你的Azure App Service开启了多实例横向扩展,缓存写入实例A,后续请求路由到实例B时,实例B的内存中没有对应缓存键,就会返回null,这是最常见的触发原因。
- 进程回收:Azure App Service会在内存占用过高、应用长时间无访问、配置更新等场景下自动回收应用进程,进程重启后所有内存缓存数据都会被清空。
- 缓存逻辑异常:代码中存在隐式的缓存删除逻辑、缓存过期时间配置错误、未判断
TryGetValue的布尔返回值直接使用out参数,都可能导致拿到null结果。
3. 查看内存缓存键值对的实现方案
由于平台没有原生工具,你需要在应用代码中自行实现调试能力,常用方案如下:
方案1:封装带键遍历能力的缓存包装类
IMemoryCache默认没有暴露所有键的遍历接口,你可以通过装饰器模式包装原生实现,自行维护缓存键集合,示例代码如下:
public class MemoryCacheWithKeyEnumerable : IMemoryCache { private readonly IMemoryCache _innerCache; private readonly ConcurrentDictionary<string, bool> _allKeys = new(); public MemoryCacheWithKeyEnumerable(IMemoryCache innerCache) { _innerCache = innerCache; } public TItem Set<TItem>(object key, TItem value, MemoryCacheEntryOptions options) { var keyStr = key.ToString(); _allKeys.TryAdd(keyStr, true); // 缓存过期时同步移除键记录 options.RegisterPostEvictionCallback((evictedKey, _, _, _) => { _allKeys.TryRemove(evictedKey.ToString(), out _); }); return _innerCache.Set(key, value, options); } public bool TryGetValue(object key, out object value) => _innerCache.TryGetValue(key, out value); public ICacheEntry CreateEntry(object key) => _innerCache.CreateEntry(key); public void Remove(object key) { _allKeys.TryRemove(key.ToString(), out _); _innerCache.Remove(key); } public void Dispose() => _innerCache.Dispose(); // 自定义方法:获取所有缓存键值对 public Dictionary<string, object> GetAllCacheEntries() { var result = new Dictionary<string, object>(); foreach (var key in _allKeys.Keys) { if (_innerCache.TryGetValue(key, out var val)) { result[key] = val; } } return result; } }
在依赖注入容器中替换默认的IMemoryCache注册后,你可以新增一个带权限校验的调试接口,调用GetAllCacheEntries即可获取所有当前缓存的键值对,注意该接口仅用于调试,生产环境不要对外暴露。
方案2:远程调试
你可以通过Visual Studio的附加调试器功能,直接附加到Azure App Service的运行进程,在调试状态下查看IMemoryCache实例的私有字段,即可看到所有存储的缓存键值,该方案仅适用于测试环境排查问题,不要在生产环境使用,避免影响业务运行。
方案3:日志埋点
在缓存写入、读取、删除的位置增加日志输出,记录操作的缓存键、值、当前应用实例ID,即可快速定位是否为跨实例导致的缓存丢失问题。
长期方案建议
如果你的应用需要多实例部署,或者需要缓存数据不随进程回收丢失,建议替换为分布式缓存方案,比如Azure Redis Cache,该服务在Azure门户自带官方控制台,可以直接执行命令查询所有缓存键值,完全符合你需要的工具能力。
内容的提问来源于stack exchange,提问作者wickjon

