多租户单数据库下如何基于EF Core实现租户独立序列管理？

针对你用ASP.NET Core + EF Core + PostgreSQL的单库多租户场景，要实现每个租户独立的作业递增编号，且避免单独维护序列的麻烦，以下是几种可行的方案：

方案1：租户序列跟踪表（完全兼容EF Core代码优先） #

创建专门的表跟踪每个租户的各类序列当前值，全程通过EF Core迁移管理，无需手动操作数据库。

1. 定义实体类 #

public class TenantSequence
{
    public int TenantId { get; set; }
    public string SequenceName { get; set; } // 标记序列类型，比如"JobNumber"
    public int CurrentValue { get; set; }

    // 复合主键：租户ID+序列名称唯一确定一条记录
    public override bool Equals(object obj) 
        => obj is TenantSequence seq && TenantId == seq.TenantId && SequenceName == seq.SequenceName;
    
    public override int GetHashCode() 
        => HashCode.Combine(TenantId, SequenceName);
}

2. 配置DbContext #

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 配置复合主键
    modelBuilder.Entity<TenantSequence>()
        .HasKey(ts => new { ts.TenantId, ts.SequenceName });
}

3. 实现编号生成逻辑 #

用事务保证原子性，避免并发场景下的编号冲突：

public async Task<int> GetNextJobNumber(int tenantId)
{
    using var transaction = await _dbContext.Database.BeginTransactionAsync();
    try
    {
        var sequence = await _dbContext.TenantSequences
            .FirstOrDefaultAsync(ts => ts.TenantId == tenantId && ts.SequenceName == "JobNumber");

        if (sequence == null)
        {
            // 租户首次生成编号，初始化序列
            sequence = new TenantSequence
            {
                TenantId = tenantId,
                SequenceName = "JobNumber",
                CurrentValue = 1
            };
            _dbContext.TenantSequences.Add(sequence);
        }
        else
        {
            // 递增当前值
            sequence.CurrentValue++;
        }

        await _dbContext.SaveChangesAsync();
        await transaction.CommitAsync();
        return sequence.CurrentValue;
    }
    catch
    {
        await transaction.RollbackAsync();
        throw;
    }
}

该方案优势：新增租户时自动初始化序列，全程通过EF Core迁移维护，无需手动操作数据库，且能保证编号的唯一性和连续性。

方案2：自定义EF Core值生成器（封装性更强） #

把编号生成逻辑封装到EF Core的ValueGenerator中，保存实体时自动生成编号，使用更简洁。

1. 实现值生成器 #

public class TenantJobNumberGenerator : ValueGenerator<int>
{
    private readonly IDbContextFactory<AppDbContext> _contextFactory;

    public TenantJobNumberGenerator(IDbContextFactory<AppDbContext> contextFactory)
    {
        _contextFactory = contextFactory;
    }

    // 标记生成的是持久化值，不是临时值
    public override bool GeneratesTemporaryValues => false;

    public override int Next(EntityEntry entry)
    {
        var job = entry.Entity as Job;
        if (job == null) 
            throw new InvalidOperationException("该生成器仅适用于Job实体");
        
        using var context = _contextFactory.CreateDbContext();
        using var transaction = context.Database.BeginTransaction();
        
        var sequence = context.TenantSequences
            .FirstOrDefault(ts => ts.TenantId == job.TenantId && ts.SequenceName == "JobNumber");

        if (sequence == null)
        {
            sequence = new TenantSequence 
            { 
                TenantId = job.TenantId, 
                SequenceName = "JobNumber", 
                CurrentValue = 1 
            };
            context.TenantSequences.Add(sequence);
        }
        else
        {
            sequence.CurrentValue++;
        }

        context.SaveChanges();
        transaction.Commit();
        return sequence.CurrentValue;
    }
}

2. 绑定到实体属性 #

在Job实体的配置中指定值生成器：

modelBuilder.Entity<Job>()
    .Property(j => j.JobNumber)
    .HasValueGenerator<TenantJobNumberGenerator>();

之后保存Job实体时，EF Core会自动调用生成器生成对应的租户专属编号。

不推荐的方案 #

• 分区表+独立序列：需要为每个租户创建单独的表分区和序列，新增租户时需手动操作，维护成本极高，不符合你避免单独维护序列的需求。
• 窗口函数生成编号：用ROW_NUMBER() OVER(PARTITION BY TenantId ORDER BY CreatedTime)仅能在查询时生成展示用的编号，无法存储，且删除数据后编号会断层，不适合需要持久化编号的场景。

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