EF Core中确保不可为空导航属性的问题排查与解决

问题场景 #

定义了包含Data的实体DataSuggestion，其中Data包含Material和Coordinates集合，实体代码如下：

public class DataSuggestion : Entity<Guid>
{
    public Guid DataId { get; init; }
    public Email Email { get; init; }
    public Comment Comment { get; init; }
    public Data Data { get; init; }

    public DataSuggestion(Email email, 
        Comment comment, 
        IEnumerable<Coordinate> coordinates, 
        Material material) : this()
    {
        Email = email;
        Comment = comment;

        Data = new Data(coordinates, material);
    }

    private DataSuggestion()
    { }
}

public class Data : ValueObject<Data>
{
    private readonly List<Coordinate> _coordinates;
    public IEnumerable<Coordinate> Coordinates => _coordinates.AsReadOnly();
    public Material Material { get; init; }

    public Data(IEnumerable<Coordinate> coordinates, 
        Material material) : this()
    {
        _coordinates = coordinates.ToList();
        Material = material;
    }

    /// <summary>
    /// EF Core constructor
    /// </summary>
    private Data()
    { }

    protected override IEnumerable<object> GetAttributesToIncludeInEqualityCheck()
    {
        return [_coordinates, Material];
    }
}

配置代码：

builder.OwnsOne(ds => ds.Comment);
builder.OwnsOne(ds => ds.Email);
        
builder.OwnsOne(ds => ds.Data, ownedNavigationBuilder =>
        {
            ownedNavigationBuilder.OwnsOne(d => d.Material);
            ownedNavigationBuilder.OwnsMany(d => d.Coordinates);
            ownedNavigationBuilder.Navigation(d => d.Material).IsRequired();
        });

运行时抛出异常：

Entity type 'Data' is an optional dependent using table sharing and containing other dependents without any required non shared property to identify whether the entity exists. If all nullable properties contain a null value in database then an object instance won't be created in the query causing nested dependent's values to be lost. Add a required property to create instances with null values for other properties or mark the incoming navigation as required to always create an instance.

用户疑问：

1. 为何需要将所有属性标记为必填，而非仅部分？
2. 若无法将Coordinates标记为必填，该如何处理此异常？
3. 补充：配置顺序影响结果，在Data的OwnedOne配置后添加builder.Navigation(ds => ds.Data).IsRequired();即可正常运行，但为何仅设置ownedNavigationBuilder.Navigation(d => d.Material).IsRequired();不足以解决问题？

问题解答 #

1. 为什么仅标记Material必填不够，而Comment无异常？ #

EF Core对拥有者实体（Owned Entity）的存在判断逻辑是：如果拥有者实体是可选的（父实体到它的导航可空），则EF需要一个明确的“存在标识”——即该拥有者实体至少有一个非共享的必填属性。

• 对于Comment：它是DataSuggestion的直接拥有者实体，自身无嵌套子依赖。即使它的字符串字段全为null，EF最多跳过创建实例，但不会丢失其他数据，因此不会触发异常。
• 对于Data：它不仅是DataSuggestion的拥有者实体，还嵌套了Material（OwnsOne）和Coordinates（OwnsMany）两个子依赖。EF需要确保：只要子依赖有数据，Data实例必须被创建，否则子依赖数据会丢失。但你标记的Material是嵌套的拥有者实体，它的字段属于共享字段，EF不会将其作为Data自身的存在标识，因此仅标记Material必填无法满足EF的判断要求。

2. 无法标记Coordinates必填时的处理方案 #

有两种可靠解决方式：

• 方式一：将父实体到Data的导航标记为必填：也就是你发现的builder.Navigation(ds => ds.Data).IsRequired();。这直接告诉EF Core，DataSuggestion永远拥有Data实例，无需判断Data是否存在，自然跳过异常触发逻辑。这也符合你的业务逻辑——DataSuggestion构造函数必须传入参数创建Data，说明业务上Data是必填项。
• 方式二：给Data添加非共享必填属性：比如给Data新增bool IsValid { get; init; }属性，构造函数中赋值为true，配置时标记为必填：

  ownedNavigationBuilder.Property(d => d.IsValid).IsRequired();
  

  这样EF就能通过该属性判断Data是否存在，即使Coordinates为空也不会触发异常。

3. 为什么标记Data导航必填能解决，而Material必填不行？ #

• 标记builder.Navigation(ds => ds.Data).IsRequired();是将父实体到Data的导航设为必填，直接跳过了EF对Data是否存在的判断逻辑——EF默认Data永远存在，无需再检查它的属性。
• 而ownedNavigationBuilder.Navigation(d => d.Material).IsRequired();仅约束Data必须拥有Material，但没有解决Data自身作为可选拥有者实体的存在判断问题。因为Material是嵌套的拥有者实体，它的字段不属于Data的“非共享属性”，无法作为Data的存在标识，所以无法满足EF的校验要求。

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