添加数据触发DbUpdateException：ProductCategories标识列插入异常

嘿，我之前也踩过这个一模一样的坑！明明没手动给标识列赋值，EF却硬说我插了显式值——大概率是模型配置或者导航属性的处理逻辑出了问题，下面给你几个排查和解决方向：

1. 先确认实体类的标识列配置是否正确 #

EF需要明确知道哪个是自动生成的标识列，如果配置错了，它就会误以为你要手动赋值。

用数据注解的方式： #

在ProductCategory的标识列（比如Id）上加[DatabaseGenerated(DatabaseGeneratedOption.Identity)]：

public class ProductCategory
{
    [DatabaseGenerated(DatabaseGeneratedOption.Identity)]
    public int Id { get; set; }
    public string Name { get; set; }
    // 其他属性...
}

用Fluent API的方式（推荐，更灵活）： #

在DbContext的OnModelCreating方法里配置：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<ProductCategory>()
        .Property(p => p.Id)
        .ValueGeneratedOnAdd(); // EF Core用这个，EF6用.DatabaseGenerated(DatabaseGeneratedOption.Identity)
}

2. 检查导航属性的关联逻辑 #

最常见的坑是：在关联其他实体时，不小心给ProductCategory的标识列带上了默认值（比如int类型的默认0），EF会把这个0当成你要插入的显式值。

举个错误的例子：

// 新建Product时关联了一个新的ProductCategory，但EF会把Category的默认Id=0当成显式值
var newProduct = new Product
{
    Name = "苹果",
    Category = new ProductCategory { Name = "水果" } // 这里Category的Id默认是0，EF会尝试插入0到标识列
};
_dbContext.Products.Add(newProduct);
_dbContext.SaveChanges(); // 报错！

解决办法：

• 如果是新建ProductCategory：确保EF知道这是全新的实体，直接添加Category再关联，或者让EF自动处理：

var newCategory = new ProductCategory { Name = "水果" };
_dbContext.ProductCategories.Add(newCategory);

var newProduct = new Product
{
    Name = "苹果",
    Category = newCategory
};
_dbContext.Products.Add(newProduct);
_dbContext.SaveChanges();

• 如果是关联已存在的ProductCategory：先从数据库查询出来再关联，不要新建实例：

var existingCategory = _dbContext.ProductCategories.FirstOrDefault(c => c.Name == "水果");
var newProduct = new Product
{
    Name = "苹果",
    Category = existingCategory
};
_dbContext.Products.Add(newProduct);
_dbContext.SaveChanges();

3. 排查DTO到实体的映射问题 #

如果你用了AutoMapper这类工具做DTO和实体的转换，很可能是DTO里的Id字段（默认值0）被映射到了实体的标识列，哪怕你没手动设置。

解决办法：在映射配置里忽略标识列：

CreateMap<ProductCategoryDto, ProductCategory>()
    .ForMember(dest => dest.Id, opt => opt.Ignore());

4. 检查实体的跟踪状态 #

有时候EF的实体跟踪会出问题，比如你之前加载过某个ProductCategory，后来新建的实体被误标记为Modified而不是Added，导致EF尝试更新而不是插入，进而报错。

可以手动设置实体状态为Added：

var newCategory = new ProductCategory { Name = "新分类" };
_dbContext.Entry(newCategory).State = EntityState.Added;
_dbContext.SaveChanges();

按照上面的步骤排查，基本能解决这个问题！

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