EF Core多聚合根迁移时使用.OwnsMany()触发空引用异常

问题场景 #

遵循DDD原则开发应用，使用聚合根、实体和值对象，已定义以下聚合根及EF Core实体配置：

• Office聚合根：包含DepartmentId列表，用于关联Department聚合根；
• Department聚合根：包含MunicipalityId列表，用于关联Municipality聚合根。

单独启用OfficeConfigurations或DepartmentConfigurations时，执行dotnet ef migrations add InitialMigration可成功生成迁移；但同时启用两个配置时，触发Object reference not set to an instance of an object空引用错误，堆栈信息指向DepartmentConfigurations中的builder.OwnsMany(d => d.MunicipalityIds, ...)代码行。

可能原因及解决方法 #

1. 聚合根集合属性未初始化 #

EF Core处理集合类型属性时，若属性未在构造函数中提前实例化，组合多聚合根配置时容易触发空引用。检查Department类的MunicipalityIds属性，确保在构造函数中初始化：

public class Department : AggregateRoot
{
    public List<Guid> MunicipalityIds { get; private set; }

    public Department()
    {
        MunicipalityIds = new List<Guid>();
    }
}

2. OwnsMany误用在简单类型集合上 #

OwnsMany设计初衷是映射值对象集合，若MunicipalityId是Guid这类简单值类型，EF Core内部映射逻辑可能出现异常。建议将MunicipalityId封装为值对象：

// 定义值对象
public record MunicipalityId(Guid Value);

// 修改Department聚合根
public class Department : AggregateRoot
{
    public List<MunicipalityId> MunicipalityIds { get; private set; } = new();
}

// 调整EF Core配置
builder.OwnsMany(d => d.MunicipalityIds, b =>
{
    b.Property(id => id.Value).HasColumnName("MunicipalityId");
    b.HasKey("Id"); // 显式配置子表主键（EF Core自动生成时可能需指定）
});

3. EF Core版本bug #

部分旧版EF Core（如6.x早期版本）在处理多聚合根的集合映射时存在兼容性问题，建议升级到最新稳定版（如8.x）后重新尝试生成迁移。

4. 配置类存在冲突 #

检查OfficeConfigurations和DepartmentConfigurations是否存在重复的实体映射规则，比如误将同一实体映射到不同表、主键配置冲突等，这类冲突可能导致EF Core内部处理时出现空引用。

5. 延迟加载代理干扰 #

若启用了延迟加载代理，可能导致集合属性未正确初始化。可尝试关闭代理生成，或确保集合属性标记为virtual并完成初始化：

// 在DbContext配置中关闭延迟加载代理
protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
    optionsBuilder.UseSqlServer("your_connection_string")
                  .UseLazyLoadingProxies(false);
}

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