Entity Framework Core 调用Add()方法时抛出异常

兄弟，我之前在.NET 8用EF Core的时候也踩过类似的坑，结合你给出的Channel实体代码片段（虽然没贴全，但从现有内容能摸到些方向），咱们来捋捋调用Add()时大概率会触发异常的几个常见问题：

1. 属性访问器权限卡了EF Core的脖子 #

你实体里的所有属性都是protected set;，EF Core在追踪实体、生成代理或者更新快照的时候，需要能正常设置这些属性值。如果非要保持setter的protected权限，咱们得给EF Core开个“后门”：

• 最简单的办法是把setter改成protected internal set;，这样EF Core的内部类就能访问到；
• 要是想严格保持protected，就用Fluent API在DbContext的OnModelCreating里指定属性的后台字段（自动属性的后台字段是编译器生成的，格式是<属性名>k__BackingField）：

  modelBuilder.Entity<Channel>(b =>
  {
      b.Property(c => c.Code).HasField("<Code>k__BackingField");
      b.Property(c => c.Name).HasField("<Name>k__BackingField");
      // 其他属性同理配置
  });
  

2. 导航属性的私有集合没被EF Core识别 #

看你写的ChannelCurrencies是暴露IReadOnlyCollection，背后用私有List字段。EF Core默认不一定能自动发现这个私有集合，导致Add实体时无法正确初始化导航属性，直接抛异常。解决办法也用Fluent API：

modelBuilder.Entity<Channel>()
    .HasMany(c => c.ChannelCurrencies)
    .WithOne(cc => cc.Channel) // 这里要对应ChannelCurrency里的反向导航属性，没有的话就写WithOne()
    .HasForeignKey(cc => cc.ChannelId) // 假设ChannelCurrency有ChannelId外键字段
    .Metadata.PrincipalToDependent.SetField("_channelCurrencies"); // 指定私有后台字段

记得要确保私有字段_channelCurrencies已经被初始化（比如private List<ChannelCurrency> _channelCurrencies = new();），不然Add的时候也会因为集合为空引发问题。

3. 缺了无参数构造函数 #

EF Core实例化实体的时候（不管是Add新实体还是从数据库加载），默认需要无参数构造函数。如果你的Channel只有带参数的构造函数，而且还是私有/受保护的，就可能触发异常。解决办法很简单，加个私有无参数构造函数就行：

private Channel() { }

// 保留你的业务构造函数
public Channel(string code, string name, int regionId, bool subscribeToIngressFlag)
{
    Code = code;
    Name = name;
    RegionId = regionId;
    SubscribeToIngressFlag = subscribeToIngressFlag;
    _channelCurrencies = new List<ChannelCurrency>();
}

你可以先从改属性setter权限开始试，比如把Code的setter临时改成public，调用Add()看会不会成功，一步步定位到底是哪个环节出的问题。

内容来源于stack exchange