EF Core Database First外键关联导航属性返回NULL问题

你的实体关系、Fluent API配置、Include查询逻辑本身没有错误，导航属性返回NULL不是EF Core关系配置缺失导致的，核心原因是JSON序列化时的循环引用截断，另外还有一处配置和数据库约束不匹配的运行时隐患。

• 循环引用问题：你用Include加载ExpenseDetails集合后，EF Core会自动执行关系修复，内存中每个ExpenseDetail的Visit导航属性会自动指向所属的Visit对象，形成Visit -> ExpenseDetails集合 -> 单个ExpenseDetail -> Visit的循环引用链。ASP.NET Core默认的System.Text.Json序列化器遇到循环引用时不会抛出错误，默认会直接将循环指向的导航属性序列化为NULL，这就是你看到两边导航属性都为空的直接原因。
• 删除行为配置不匹配：你当前配置的OnDelete(DeleteBehavior.ClientSetNull)要求外键可为空，但你数据库中expense_details表的visit_id字段是NOT NULL非空约束，后续执行删除操作时会触发数据库级的约束报错。

1. 解决循环引用序列化问题 #

在Program.cs的服务注册阶段，修改JSON序列化配置即可：

builder.Services.AddControllers()
    .AddJsonOptions(opt =>
    {
        // 遇到循环引用时自动忽略循环指向的对象，不会将属性置为NULL
        opt.JsonSerializerOptions.ReferenceHandler = System.Text.Json.Serialization.ReferenceHandler.IgnoreCycles;
        // 可选：统一返回小驼峰格式的属性名，适配前端调用习惯
        opt.JsonSerializerOptions.PropertyNamingPolicy = System.Text.Json.JsonNamingPolicy.CamelCase;
    });

如果你项目用Newtonsoft.Json做序列化，配置改为：

builder.Services.AddControllers()
    .AddNewtonsoftJson(opt =>
    {
        opt.SerializerSettings.ReferenceLoopHandling = Newtonsoft.Json.ReferenceLoopHandling.Ignore;
    });

更优实践：如果接口不需要返回反向导航属性的数据，直接定义DTO做投影查询，只返回需要的字段，从根源上避免循环引用，同时减少接口返回的冗余数据，示例代码如下：

// 定义返回用的DTO，不要带循环引用的导航属性
public class VisitDto
{
    public int Id { get; set; }
    public int UserId { get; set; }
    public string Description { get; set; }
    // 其他接口需要的Visit字段
    public List<ExpenseDetailDto> ExpenseDetails { get; set; }
}

public class ExpenseDetailDto
{
    public int Id { get; set; }
    public decimal ExpenseAmount { get; set; }
    // 其他接口需要的ExpenseDetail字段，不要包含Visit类型的属性
}

// 接口改造
[HttpGet]
public IEnumerable<VisitDto> Get()
{
    return tourActivityExpenseContext.Visits
        .Select(v => new VisitDto
        {
            Id = v.Id,
            UserId = v.UserId,
            Description = v.Description,
            ExpenseDetails = v.ExpenseDetails.Select(e => new ExpenseDetailDto
            {
                Id = e.Id,
                ExpenseAmount = e.ExpenseAmount
            }).ToList()
        }).ToList();
}

2. 修正删除行为配置 #

修改ModelBuilder中的OnDelete配置，和数据库非空外键约束匹配：

entity.HasOne(d => d.Visit)
    .WithMany(p => p.ExpenseDetails)
    .HasForeignKey(d => d.VisitId)
    // 根据业务需求二选一：Cascade为删除Visit时自动删除关联的报销明细；Restrict为存在关联明细时禁止删除Visit
    .OnDelete(DeleteBehavior.Cascade)
    .HasConstraintName("FK_expense_details_visit");

补充说明 #

你当前查询代码中的.Include(e => e.ExpenseDetails)已经可以正确加载Visit关联的ExpenseDetails集合，不需要额外为了加载数据补充关系配置：

• EF Core的关系修复机制会自动关联已经加载到上下文的实体，不需要额外Include反向导航属性
• 只有当你直接查询ExpenseDetail、需要附带关联的Visit数据时，才需要写.Include(d => d.Visit)

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