EF Core 7.0调用OwnsOne时内部抛出NullReferenceException问题

问题背景 #

使用EntityFrameworkCore v7.0.0（搭配SQL Server适配器），在调用.OwnsOne(...)关联拥有实体ProductName到主体实体Product时，EF Core生成影子外键过程中内部抛出NullReferenceException，堆栈跟踪指向Microsoft.EntityFrameworkCore.Metadata.Internal.InternalEntityTypeBuilder.CreateForeignKey方法。

可能原因 #

从堆栈和代码分析，核心问题是主体实体Product的主键未被EF Core正确识别或初始化，导致在创建拥有实体的外键关联时，找不到有效的主键引用，触发空引用异常。具体可能的点包括：

• AggregateRoot<TId>中的Id属性访问级别问题（如为protected且配置类无法正确访问）
• Product的私有构造函数未正确初始化基类的Id属性
• 主键配置未被EF Core正确解析

解决方案 #

1. 确保AggregateRoot的Id属性可被EF正确访问 #

修改AggregateRoot<TId>，确保Id属性为public或在同一程序集内可被配置类访问，同时提供必要的构造函数：

public abstract class AggregateRoot<TId> where TId : notnull
{
    public TId Id { get; protected set; }

    // 领域模型构造函数
    protected AggregateRoot(TId id)
    {
        Id = id;
    }

    // EF Core需要的无参构造函数（可设为protected/private）
    protected AggregateRoot() { }
}

2. 完善Product类的构造函数 #

确保Product的私有构造函数调用基类构造函数，保证EF Core实例化时Id属性能被正确初始化：

public class Product : AggregateRoot<ProductId>
{
    // EF Core专用私有构造函数
    private Product() : base() { }

    // 领域模型构造函数
    public Product(ProductId id, ProductName name) : base(id)
    {
        Name = name;
    }

    public ProductName Name { get; private set; }
}

3. 验证主键配置 #

如果Id属性是protected且配置类在不同程序集，可改用字符串形式指定主键，避免Lambda表达式访问权限问题：

// 在ProductConfiguration中替换原HasKey配置
builder.HasKey("Id");

4. 确保ValueObject的完整性 #

作为值对象，ProductName需正确实现Equals和GetHashCode（这是值对象的核心要求，也避免EF Core映射时出现意外问题）：

public class ProductName : ValueObject 
{
    public string Value { get; private set; }

    public ProductName(string value)
    {
        Value = value;
    }

    protected override IEnumerable<object> GetEqualityComponents()
    {
        yield return Value;
    }
}

验证 #

修改后重新运行迁移或上下文初始化，EF Core应该能正确生成影子外键并完成拥有实体的映射，不再抛出空引用异常。

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