EF Code First一对多关系中更新导航对象的空引用异常问题

先给你还原场景里的实体和上下文定义，方便理解问题：

// Branch实体
public class Branch
{
    public int Id { get; set; }
    public string Name { get; set; }
    public ICollection<Project> Projects { get; set; } = new List<Project>();
}

// Project实体
public class Project
{
    public int Id { get; set; }
    public string Name { get; set; }
    public int? BranchId { get; set; } // 外键字段
    public Branch Branch { get; set; } // 导航属性
}

// DbContext定义
public class AppDbContext : DbContext
{
    public DbSet<Branch> Branches { get; set; }
    public DbSet<Project> Projects { get; set; }

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        optionsBuilder.UseSqlServer("你的数据库连接字符串");
    }
}

问题场景复现 #

你遇到的情况是：

1. 先在一个DbContext实例中创建未关联Branch的Project并保存
2. 之后在另一个DbContext实例中获取目标Branch
3. 再在第三个DbContext实例中尝试把Project关联到这个Branch，两种操作方式结果完全不同：

方式1：正常执行（直接操作外键） #

// 第一步：创建无关联的Project
using (var ctx1 = new AppDbContext())
{
    var project = new Project { Name = "MyTestProject" };
    ctx1.Projects.Add(project);
    ctx1.SaveChanges();
}

// 第二步：在另一个上下文获取目标Branch
Branch targetBranch;
using (var ctx2 = new AppDbContext())
{
    targetBranch = ctx2.Branches.First(b => b.Name == "DevBranch");
}

// 第三步：在新上下文关联Project和Branch
using (var ctx3 = new AppDbContext())
{
    var project = ctx3.Projects.Find(1);
    project.BranchId = targetBranch.Id; // 直接设置外键
    ctx3.SaveChanges(); // 执行正常
}

方式2：触发NullReferenceException（直接赋值导航属性） #

// 前面步骤和方式1一致
using (var ctx3 = new AppDbContext())
{
    var project = ctx3.Projects.Find(1);
    project.Branch = targetBranch; // 直接赋值导航属性
    ctx3.SaveChanges(); // 这里抛出NullReferenceException
}

为什么会报错？ #

你说得没错，这确实是预期行为，核心原因是：

• targetBranch是来自ctx2的实体实例，当ctx2被using块自动Dispose后，这个Branch对象就变成了游离状态——它不再被任何DbContext追踪，而且如果你的实体没有启用延迟加载代理（或者代理已失效），它的导航属性（比如Projects）可能处于未初始化的null状态。
• 当你把这个游离的Branch赋值给ctx3中Project的Branch导航属性时，EF Core在处理关联关系时会尝试访问这个游离对象的内部追踪状态或导航属性，一旦碰到未初始化的null属性，就会触发空引用异常。

解决方法 #

给你三个实用的解决方案，按推荐程度排序：

1. 优先操作外键属性（最推荐） #

就像方式1那样，直接设置BranchId而不是Branch导航属性。这种方式完全不依赖导航对象的状态，不管是不是跨上下文，都能稳定工作，代码也更简洁。

2. 将游离实体附加到当前上下文 #

如果业务逻辑必须使用导航属性赋值，可以先把游离的Branch附加到当前操作的DbContext中，让上下文重新追踪它：

using (var ctx3 = new AppDbContext())
{
    var project = ctx3.Projects.Find(1);
    // 把游离的Branch附加到当前上下文
    ctx3.Attach(targetBranch);
    // 手动指定状态为Unchanged，避免EF误判为新增或修改
    ctx3.Entry(targetBranch).State = EntityState.Unchanged;
    
    project.Branch = targetBranch;
    ctx3.SaveChanges();
}

注意：如果targetBranch在原上下文之后有过修改，你需要根据实际情况调整实体状态（比如EntityState.Modified）。

3. 尽量在同一个DbContext实例中完成操作 #

如果业务流程允许，把获取Branch、获取Project、关联保存的操作放在同一个DbContext实例里，这样所有实体都处于上下文的追踪状态，不会出现游离对象的问题：

using (var ctx = new AppDbContext())
{
    var project = ctx.Projects.Find(1);
    var targetBranch = ctx.Branches.First(b => b.Name == "DevBranch");
    project.Branch = targetBranch;
    ctx.SaveChanges();
}

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