Entity Framework使用表共享时为何出现可选依赖警告？

问题描述 #

收到EF Core警告：

Microsoft.EntityFrameworkCore.Update: Warning: The entity of type 'Event.Description#RichText' is an optional dependent using table sharing. The entity does not have any property with a non-null value to identify whether the entity exists. This means that when it is queried no object instance will be created instead of an instance with all properties set to null values. Any nested dependents will also be lost. Either don't save any instance with only null values or mark the incoming navigation as required in the model. Consider using 'DbContextOptionsBuilder.EnableSensitiveDataLogging' to see the key values of the entity.

相关实体代码：

public class Event
{
    public RichText? Description { get; set; }
}

public class RichText
{
    public string OpenXmlFilename { get; private set; }
    public string HtmlFilename { get; private set; }
    public string HtmlBody { get; private set; }
    public string Text { get; private set; }
    public RichText()
    {
        OpenXmlFilename = HtmlFilename = Text = HtmlBody = string.Empty;
    }
}

疑问：警告提示无法保存所有属性均为null的Description，但RichText所有属性都被初始化为非空字符串，根本无法创建全null的实例，为何会触发该警告？如果永远不会实例化全null的RichText对象，是否会有问题？

更新补充代码 #

实体配置代码 #

public class EventConfiguration : IEntityTypeConfiguration<Event>
{
    public void Configure(EntityTypeBuilder<Event> builder)
    {
        builder.OwnsOne(u => u.Description, desc =>
        {
            desc.Property(a => a.OpenXmlFilename).IsRequired();
        });
    }
}

模型快照代码片段 #

modelBuilder.Entity("LouisHowe.core.Models.Event", b =>
    {
        b.OwnsOne("LouisHowe.core.Models.RichText", "Description", b1 =>
            {
                b1.Property<int>("EventId")
                    .HasColumnType("int");

                b1.Property<string>("HtmlBody")
                    .IsRequired()
                    .HasColumnType("nvarchar(max)");

                b1.Property<string>("HtmlFilename")
                    .IsRequired()
                    .HasColumnType("nvarchar(max)");

                b1.Property<string>("OpenXmlFilename")
                    .IsRequired()
                    .HasColumnType("nvarchar(max)");

                b1.Property<string>("Text")
                    .IsRequired()
                    .HasColumnType("nvarchar(max)");

                b1.HasKey("EventId");

                b1.ToTable("Events");

                b1.WithOwner()
                    .HasForeignKey("EventId");
            });

问题解析与解答 #

警告触发原因 #

EF Core的警告逻辑基于模型元数据判断，而非你的代码初始化逻辑：

1. Event.Description被声明为可选导航属性（RichText?），EF允许该属性为null。
2. 尽管RichText的属性在构造函数中被初始化为空字符串，但EF Core无法感知到这个初始化逻辑——它仅识别属性的类型为string，而可空引用类型的规则需要在EF模型中显式配置。
3. 加上你使用了表共享的Owned Entity（OwnsOne），EF需要明确依据来区分“依赖实体不存在（导航为null）”和“依赖实体存在但所有属性为默认值”。由于RichText没有能区分这两种状态的非空标识属性，EF就抛出了该警告。

是否会有问题？ #

如果能绝对保证以下两种情况不会发生，理论上不会出现运行问题：

• 不会将Event.Description设为null后保存
• 不会出现RichText所有属性被设为null的实例（即使构造函数初始化了空字符串，也要确保后续不会被修改为null）

但实际开发中建议解决该警告，避免隐性问题：比如后续代码若不慎将RichText的属性设为null，EF会直接丢弃整个实体实例，导致数据丢失。

解决方案 #

有两种常用解决方式：

1. 将导航属性设为必填：如果Event必须包含Description，直接修改Event中的导航属性为非可选：

   public class Event
   {
       public RichText Description { get; set; } = new RichText();
   }
   

   同时在配置中标记导航为必填：

   builder.OwnsOne(u => u.Description, desc =>
   {
       desc.Property(a => a.OpenXmlFilename).IsRequired();
   }).Navigation(e => e.Description).IsRequired();
   

2. 添加标识属性区分实体是否存在：如果Description确实需要是可选的，给RichText添加一个bool类型的属性（如IsActive）并配置为必填，用来标记实体是否存在：

   public class RichText
   {
       public bool IsActive { get; private set; } = true;
       // 其他属性保持不变
   }
   

   然后在配置中标记该属性为必填：

   builder.OwnsOne(u => u.Description, desc =>
   {
       desc.Property(a => a.OpenXmlFilename).IsRequired();
       desc.Property(a => a.IsActive).IsRequired();
   });
   

   这样EF就能通过IsActive的值判断RichText实体是否存在。

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