Entity Framework中PostgreSQL主键值冲突问题及解决咨询

问题根源 #

你遇到的主键冲突，本质是PostgreSQL的自增序列与表中已存在的主键值不同步。当你手动插入了30条指定Id的测试数据后，数据库的自增序列仍停留在初始状态（从0开始），导致EF通过序列生成的主键和已存在的记录重复。

解决方案 #

1. 手动同步PostgreSQL序列（最快解决） #

直接在PostgreSQL中执行SQL，将序列的当前值更新为表中最大Id+1，确保下一次生成的主键不会冲突：

-- 更新Products表的自增序列
SELECT setval('products_id_seq', (SELECT MAX(id) FROM products));

-- 更新ProductCategories表的自增序列
SELECT setval('product_categories_id_seq', (SELECT MAX(id) FROM productcategories));

-- 更新ProductImages表的自增序列
SELECT setval('product_images_id_seq', (SELECT MAX(id) FROM productimages));

如果需要强制从31开始生成（不管当前最大Id），可以用：

SELECT setval('products_id_seq', 31, false);
-- 参数说明：第三个参数为false时，下一次调用nextval会返回31；为true时返回32

2. 通过EF模型配置指定序列起始值（长期规范） #

在ProductContext中重写OnModelCreating方法，配置每个实体的自增序列起始值，确保迁移时数据库序列初始化正确：

using Microsoft.EntityFrameworkCore;

public class ProductContext : DbContext
{
    public ProductContext(DbContextOptions<ProductContext> options)
        : base(options)
    {
    }

    public DbSet<Models.Product> Products { get; set; } = default!;
    public DbSet<Models.ProductCategory> ProductCategories { get; set; } = default!;
    public DbSet<Models.ProductImage> ProductImages { get; set; } = default!;

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        // 配置Products表自增序列起始值
        modelBuilder.Entity<Models.Product>()
            .Property(p => p.Id)
            .UseIdentityColumn(startValue: 1);

        // 配置ProductCategories表自增序列起始值
        modelBuilder.Entity<Models.ProductCategory>()
            .Property(c => c.Id)
            .UseIdentityColumn(startValue: 1);

        // 配置ProductImages表自增序列起始值
        modelBuilder.Entity<Models.ProductImage>()
            .Property(i => i.Id)
            .UseIdentityColumn(startValue: 1);
    }
}

注意：如果数据库已存在数据，需要先手动同步序列（方案1），再执行迁移生效。

3. 规范测试数据插入方式（避免复发） #

后续插入测试数据时，不要手动指定Id字段值，让EF和PostgreSQL自动生成主键。比如插入Product的代码改为：

var testProduct = new Models.Product
{
    Name = "测试商品",
    Price = 99.9m,
    // 不设置Id，让数据库自动生成
};
await _productRepository.AddProductAsync(testProduct);

这样能保证序列和表中数据始终同步，不会再出现冲突。

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