EF Core未使用本地缓存实体版本的问题排查

你对EF Core的本地缓存机制存在普遍的认知误区：EF Core 自带的上下文级缓存（身份映射缓存）默认不会拦截所有普通LINQ查询，不是只要上下文复用、之前查过实体，后续所有查询就会自动走本地内存。

核心规则说明 #

• 你当前写的Where(u => u.SomeId == xxx).SingleAsync()属于标准的LINQ to Entities查询，默认行为永远是生成SQL发送到数据库执行，和本地有没有缓存对应实体没有关系。哪怕本地已经追踪了匹配的实体，这个查询依然会发请求到数据库，只是数据库返回结果后，如果结果的主键和本地已追踪实体主键匹配，EF Core会直接返回本地已存在的实体实例，不会用数据库返回值覆盖本地实体的当前状态，也不会新建实体对象，但数据库请求本身是一定会发的。
• EF Core默认只有两种场景会直接查询本地缓存、不发送数据库请求：
  • 使用Find()/FindAsync()方法按主键查询：这个方法是EF Core专门设计的，会优先遍历本地追踪的实体集合，找到主键匹配的实体就直接返回，完全不访问数据库；只有本地找不到对应主键的实体时，才会生成SQL去数据库查询。
  • 显式访问DbSet<T>.Local属性：Local是上下文维护的、所有已追踪实体的内存集合，在Local上写的所有LINQ查询都是纯内存操作，不会生成任何SQL，自然不会访问数据库，但它只能查到已经被上下文加载、追踪过的实体，从来没加载过的实体不会出现在Local里。

对应修改方案 #

如果你的查询是按主键匹配，直接换成FindAsync即可触发本地缓存优先的逻辑：

// 假设SomeId是SomeEntityType的主键，本地缓存命中时不会发送数据库请求
await _sharedContext.Set<SomeEntityType>()
    .FindAsync(new object?[] { status.SomeOtherField }, cancel);

如果你需要按非主键条件查询本地已追踪的实体，直接在Local集合上查询：

// 纯内存查询，无数据库访问，仅返回已被上下文追踪的匹配实体
var matchEntity = _sharedContext.Set<SomeEntityType>()
    .Local
    .FirstOrDefault(u => u.SomeId == status.SomeOtherField);

额外注意 #

长期全局复用同一个DbContext实例本身不符合EF Core的设计最佳实践：DbContext是轻量级、短生命周期的组件，全局共享会导致追踪的实体持续增长引发内存泄漏，同时存在线程安全风险、实体状态意外污染的问题。
另外如果你需要的是跨上下文、同查询语句直接返回缓存结果的二级缓存能力，EF Core本身没有内置这个功能，需要额外引入二级缓存的相关实现。

内容的提问来源于stack exchange，提问作者Kieren Johnstone