EF Core对接CosmosDB使用OwnsOne/OwnsMany抛NullReferenceException

根因说明 #

你遇到的空引用异常是EF Core 5.0.x版本Cosmos提供程序的已知问题，触发原因是你手动将顶层实体的State设置为EntityState.Added时，EF的内部跟踪逻辑不会自动递归处理关联的Owned子实体，导致访问未初始化的元数据对象抛出空引用。

可行修复方案 #

方案1：修改通用Add方法（最推荐） #

将手动设置实体状态的写法替换为调用DbSet.Add()方法，该方法会自动递归处理所有Owned子实体的跟踪状态，完全规避该问题：

public virtual TEntity Add(TEntity entity)
{
    _context.Set<TEntity>().Add(entity);
    _context.SaveChanges();
    return entity;
}

方案2：升级NuGet包版本 #

如果你无法修改通用服务层代码，可将Microsoft.EntityFrameworkCore.Cosmos升级到.NET 5支持的最新稳定版5.0.17，该版本已修复该Owned实体跟踪的空引用bug。

方案3：调整Owned实体初始化逻辑（临时兼容方案） #

如果既不能改服务代码也不能升级包，可将Owned实体的初始化逻辑从构造函数中移出，在顶层实体创建完成后再赋值，同时在配置Owned属性时显式标记可空：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.HasDefaultContainer(nameof(Questionnaires));
    modelBuilder.Entity<Questionnaire>().HasKey(q => q.Id);
    modelBuilder.Entity<Questionnaire>().OwnsOne(q => q.TV, t => t.IsRequired(false));
}

OwnsMany嵌套配置注意事项 #

后续实现嵌套集合存储时，需显式配置每一层Owned实体的层级，不能省略嵌套配置：

// 示例：配置嵌套的Forms集合及集合内的子属性
modelBuilder.Entity<Questionnaire>()
    .OwnsMany(q => q.Forms, f =>
    {
        f.HasNoKey();
        f.OwnsMany(x => x.SubFields);
        // 其他子属性配置
    });

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