Entity Framework Core查询时无法加载关联实体对象如何解决

AI 小北

2026-10-5

EF Core查询无法加载关联导航属性的解决方案

EF Core默认不会自动加载关联导航属性，你当前的查询没有指定加载SubItems导航属性，所以返回值为null，可按需选择以下方案解决：

方案1：显式贪婪加载（推荐，性能最优）

这是生产环境最常用的方式，在查询时通过Include方法指定要加载的关联属性，避免额外的数据库查询开销：

先引入EF Core相关命名空间：

using Microsoft.EntityFrameworkCore;

修改控制器查询代码：

// GET: api/Todo
[HttpGet]
public async Task<ActionResult<IEnumerable<TodoItemT>>> GetTodoItemTs()
{
    return await _context.TodoItemTs
        .Include(t => t.SubItems) // 显式指定加载SubItems关联属性
        .ToListAsync();
}

方案2：开启懒加载（按需加载）

如果希望访问导航属性时自动触发加载，可以配置懒加载代理：

先安装对应版本的NuGet包：Microsoft.EntityFrameworkCore.Proxies
修改Startup.cs的DbContext配置：

services.AddDbContext<TodoContext>(opt => 
    opt.UseLazyLoadingProxies() // 开启懒加载代理
        .UseInMemoryDatabase("TodoList"));

注意：你当前的导航属性已经标记了virtual关键字，符合懒加载的要求，不需要额外修改实体定义。

额外注意：循环序列化问题

因为你的SubItemT实体中存在反向导航属性TodoItemT，序列化返回时会触发循环引用报错，需要配置Json序列化规则忽略循环引用：

builder.Services.AddControllers()
    .AddJsonOptions(options =>
    {
        options.JsonSerializerOptions.ReferenceHandler = System.Text.Json.Serialization.ReferenceHandler.IgnoreCycles;
    });

也可以直接在SubItemT的TodoItemT导航属性上添加[JsonIgnore]特性，避免反向属性被序列化。