从EF4迁移至EF7：关联实体未加载问题的检测工具咨询

问题背景 #

将EF4项目迁移至EF7后，依赖Lazy Loading获取关联实体的代码出现隐性bug：无编译错误，但内存中访问已加载实体的导航属性时返回空集合（如示例中childrens.Count()返回0），需手动添加Include预加载才能恢复正常。由于此类问题无编译提示，需批量检测定位。

检测方法与工具 #

1. EF Core内置日志与分析器 #

• 启用详细日志：配置DbContext的日志输出到控制台或文件，查看延迟加载失败的记录。当上下文已释放或导航属性无法被延迟加载时，EF7会在Debug级别日志中输出相关提示。

  protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
  {
      var loggerFactory = LoggerFactory.Create(builder =>
      {
          builder.AddFilter(category => category.StartsWith("Microsoft.EntityFrameworkCore"))
                 .AddConsole()
                 .SetMinimumLevel(LogLevel.Debug);
      });
      optionsBuilder.UseLoggerFactory(loggerFactory);
  }
  

• 使用EF Core分析器：安装NuGet包Microsoft.EntityFrameworkCore.Analyzers，该工具会在编译时检测客户端查询中访问未预加载导航属性的代码，生成警告（如规则EF1001），直接定位需要添加Include的位置。

2. 静态代码分析自定义规则 #

基于Roslyn编写自定义分析器，扫描代码中所有在ToList()/ToArray()等内存转换操作后访问导航属性的逻辑，标记为可疑代码。核心思路是：

• 识别所有客户端查询（即已脱离EF上下文跟踪的实体集合）
• 检测这些集合中对导航属性的访问，提示需要确认是否添加Include

3. 单元测试对比验证 #

复用原有EF4项目的测试用例，在EF7环境下重新执行：

• 对涉及关联实体查询的测试用例，添加断言验证关联集合的数量或内容是否符合预期
• 失败的测试用例直接对应需要修复的查询位置，快速定位隐性bug

4. 运行时拦截检测 #

实现EF Core的拦截器，监听延迟加载事件，当出现无效的延迟加载请求时记录警告：

public class LazyLoadingChecker : ILazyLoadingInterceptor
{
    public void OnLazyLoading(LazyLoadingInterceptionData eventData, LazyLoadingResult result)
    {
        if (eventData.Context.IsDisposed)
        {
            Debug.WriteLine($"警告：尝试延迟加载实体{eventData.EntityType.Name}的导航属性{eventData.Navigation.Name}，但DbContext已释放，请添加Include预加载");
        }
    }
}

在DbContext中注册拦截器：

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
    optionsBuilder.AddInterceptors(new LazyLoadingChecker());
}

运行项目时，控制台会输出所有无效延迟加载的警告，直接定位问题代码。

内容的提问来源于stack exchange，提问作者JeeShen Lee