EF Core 如何设置字符串与自增整数拼接的实体主键

EF Core本身没有提供直接通过FluentAPI或数据注解（Attribute）一键配置「前缀+自增整数」格式字符串主键的能力，你可以通过以下几种方案实现需求： #

方案1：数据库计算列实现（推荐，并发安全） #

给每个实体加单独的自增整数字段，将主键设置为数据库计算列自动拼接前缀和自增数值，无需业务层处理。

示例代码 #

1. 定义实体

public class User
{
    // 最终带前缀的主键
    public string Id { get; set; }
    // 数据库自增序列字段，不对外暴露
    public int AutoIncrementSeq { get; set; }
    
    // 其他业务字段
    public string Name { get; set; }
}

2. FluentAPI配置（以SQL Server为例）

modelBuilder.Entity<User>(b =>
{
    b.HasKey(x => x.Id);
    // 配置自增字段，插入时自动生成值
    b.Property(x => x.AutoIncrementSeq).ValueGeneratedOnAdd();
    // 配置Id为持久化计算列，自动拼接前缀和自增序号
    b.Property(x => x.Id)
     .HasComputedColumnSql("'u' + CAST(AutoIncrementSeq AS VARCHAR(10))", stored: true);
});

不同数据库的计算列语法可以对应调整，比如PostgreSQL写成"'u' || CAST(AutoIncrementSeq AS VARCHAR(10))"即可。 #

方案2：EF保存拦截/钩子实现（跨数据库兼容） #

如果需要适配多数据库，不想依赖数据库专属特性，可以在EF的保存节点统一生成主键。

示例代码 #

1. 定义通用接口约束实体

public interface IPrefixedIdEntity
{
    string Id { get; set; }
    // 每个实体对应的主键前缀
    string IdPrefix { get; }
}

// 实体实现接口
public class User : IPrefixedIdEntity
{
    public string Id { get; set; }
    public string IdPrefix => "u";
    // 其他字段
}

public class Customer : IPrefixedIdEntity
{
    public string Id { get; set; }
    public string IdPrefix => "c";
    // 其他字段
}

2. 重写DbContext的Save方法统一生成主键

public override int SaveChanges(bool acceptAllChangesOnSuccess)
{
    GeneratePrefixedIds();
    return base.SaveChanges(acceptAllChangesOnSuccess);
}

public override Task<int> SaveChangesAsync(bool acceptAllChangesOnSuccess, CancellationToken cancellationToken = default)
{
    GeneratePrefixedIds();
    return base.SaveChangesAsync(acceptAllChangesOnSuccess, cancellationToken);
}

private void GeneratePrefixedIds()
{
    // 筛选所有待插入的带前缀主键实体
    var addedEntities = ChangeTracker.Entries<IPrefixedIdEntity>()
        .Where(e => e.State == EntityState.Added)
        .ToList();

    foreach (var entry in addedEntities)
    {
        var entity = entry.Entity;
        var entityType = entry.Metadata.ClrType;
        
        // 查询当前实体的最大序号
        var maxIdNum = Set(entityType)
            .Cast<IPrefixedIdEntity>()
            .Max(e => e.Id == null ? 0 : int.Parse(e.Id.Replace(entity.IdPrefix, "")));
        
        entity.Id = $"{entity.IdPrefix}{maxIdNum + 1}";
    }
}

注意：高并发场景下该简单实现可能出现主键重复，建议搭配分布式序号生成器使用，同时在数据库层给Id字段加唯一索引避免脏数据。

方案3：数据库序列实现 #

如果使用支持序列的数据库（SQL Server、PostgreSQL、MySQL 8.0+），可以给每个实体创建独立的序列，插入时直接拿序列值拼接前缀，也是并发安全的方案。

示例配置（以PostgreSQL为例） #

// 给User实体创建专属序列
modelBuilder.HasSequence<int>("UserSeq").StartsAt(1).IncrementsBy(1);
modelBuilder.Entity<User>()
    .Property(u => u.Id)
    .HasDefaultValueSql("'u' || nextval('\"UserSeq\"')");

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