EF Core Code-First复合键报错：实体无法被跟踪问题排查

核心问题是EF Core未正确识别你配置的复合键， fallback到自动生成的TempId临时跟踪键，而多个种子实体的TempId值重复（如默认0/null），触发了实体跟踪冲突。具体诱因包括：

• 复合键配置有误（比如属性顺序错误、类型不匹配，或未正确标记为主键）
• 复合键对应的实体属性被设为可空（主键字段不能为null，否则EF会判定其无效）
• 添加Id字段后未明确主键规则，导致EF主键识别混乱
• EF Core或Npgsql版本与Postgres 9.6不兼容，影响主键解析逻辑

1. 修正复合键配置（核心步骤） #

确保OnModelCreating中的复合键配置准确，且实体类的主键属性非空：

实体类示例（保证主键属性非空）

public class GamingLimit
{
    // 不可空属性，对应复合键
    public string PlayerNationalIdHash { get; set; }
    public string Timeframe { get; set; }
    
    // 其他业务属性
    public decimal LimitAmount { get; set; }
}

上下文配置示例

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    base.OnModelCreating(modelBuilder);
    
    // 明确指定复合键
    modelBuilder.Entity<GamingLimit>()
        .HasKey(gl => new { gl.PlayerNationalIdHash, gl.Timeframe });
}

2. 规范种子数据添加逻辑 #

避免添加重复复合键的实体，或在添加前检查上下文跟踪状态：

方式1：使用HasData在模型构建时添加种子数据（推荐）

modelBuilder.Entity<GamingLimit>().HasData(
    new GamingLimit { PlayerNationalIdHash = "user_hash_01", Timeframe = "Daily", LimitAmount = 100 },
    new GamingLimit { PlayerNationalIdHash = "user_hash_01", Timeframe = "Weekly", LimitAmount = 500 },
    new GamingLimit { PlayerNationalIdHash = "user_hash_02", Timeframe = "Daily", LimitAmount = 150 }
);

方式2：手动添加时先校验重复

var seedLimits = new List<GamingLimit>
{
    new GamingLimit { PlayerNationalIdHash = "user_hash_01", Timeframe = "Daily", LimitAmount = 100 },
    // 其他种子数据
};

foreach (var limit in seedLimits)
{
    if (!context.GamingLimits.Any(gl => 
        gl.PlayerNationalIdHash == limit.PlayerNationalIdHash 
        && gl.Timeframe == limit.Timeframe))
    {
        context.GamingLimits.Add(limit);
    }
}
context.SaveChanges();

3. 处理Id字段的两种方案 #

• 方案A：保留复合键，删除Id字段：如果Id是冗余字段，直接移除，避免干扰EF的主键识别逻辑。
• 方案B：用Id做主键，原字段设为唯一约束：若必须保留Id，调整配置：

modelBuilder.Entity<GamingLimit>()
    .HasKey(gl => gl.Id) // 设Id为主键
    .HasIndex(gl => new { gl.PlayerNationalIdHash, gl.Timeframe }) // 原字段设为唯一约束
    .IsUnique();

4. 匹配EF与Postgres版本 #

Postgres 9.6仅兼容EF Core 2.x/3.x版本，对应使用Npgsql.EntityFrameworkCore.PostgreSQL的2.2.x/3.1.x版本，避免因版本不兼容导致的主键解析异常。

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