首次向CosmosDB植入Metadata数据时遇实体跟踪冲突错误求助

问题原因 #

你遇到的System.InvalidOperationException是因为实体配置错误：在MetadataConfiguration中使用builder.HasMany(x => x.Data)，这会让EF Core将Data视为独立的可跟踪实体，但在Cosmos DB的文档模型中，Data是嵌套在Metadata文档中的子对象，不应被当作独立实体处理。由于Data类未定义主键，EF Core会自动生成隐式的__id字段，错误的实体配置导致EF在跟踪时误判存在重复键的Data实例。

解决步骤 #

1. 修正实体配置（关键） #

将Data配置为Metadata的拥有实体（Owned Entity），告诉EF Core它是Metadata文档的一部分，不需要独立跟踪：

public class MetadataConfiguration : IEntityTypeConfiguration<Metadata>
{
   public void Configure(EntityTypeBuilder<Metadata> builder)
   {
       builder
         .HasNoDiscriminator()
         .ToContainer(nameof(MyDBContext.Metadata))
         .HasPartitionKey(x => x.PartitionKey)
         .HasKey(x => x.Id);
       
       // 替换原有的HasMany配置为拥有实体配置
       builder.OwnsMany(x => x.Data, b =>
       {
           b.Property(d => d.Key);
           b.Property(d => d.Value);
       });
       
       builder.Property(x => x.Id).ToJsonProperty("id");
    }
}

2. 优化初始化查询（可选但推荐） #

将DbInitializer中的context.Metadata.Count()改为AsNoTracking()版本，避免不必要的实体跟踪：

if (context.Metadata.AsNoTracking().Count() == 0)
{
    // 初始化逻辑不变
}

3. 简化添加操作（可选） #

因为你只添加单个Metadata实例，AddRange可以替换为Add，语义更清晰：

context.Metadata.Add(metadata);

验证修改 #

重新运行初始化逻辑，EF Core会正确将Data集合嵌套到Metadata文档中，不会再触发跟踪冲突错误。

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