如何基于C# EF Code First为多租户生成专属数据库及对应表？

我帮你拆解下这个需求的实现步骤，核心分为公共租户库的存储、动态创建租户数据库、EF上下文动态配置这几个关键环节：

1. 公共数据库上下文（MyAppDB）配置 #

首先你需要一个操作公共数据库MyAppDB的EF上下文，用来存储租户信息：

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

    // 对应公共库的tblTenants表
    public DbSet<Tenant> Tenants { get; set; }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        // 配置租户名称唯一约束
        modelBuilder.Entity<Tenant>()
            .HasIndex(t => t.TenantName)
            .IsUnique();
    }
}

// 租户实体类
public class Tenant
{
    public int Id { get; set; }
    public string TenantName { get; set; }
    // 可扩展其他租户信息，比如创建时间、状态等
}

记得在appsettings.json里配置公共库的连接字符串：

"ConnectionStrings": {
    "TenantCommonDb": "Server=YOUR_SERVER;Database=MyAppDB;Trusted_Connection=True;TrustServerCertificate=True;"
}

然后在Program.cs里注册这个上下文：

builder.Services.AddDbContext<TenantDbContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("TenantCommonDb")));

2. 租户注册成功后动态创建数据库 #

当用户提交注册表单并验证租户名称唯一后，你需要完成「存入租户信息→创建租户数据库→生成业务表」的流程，这里可以写一个服务类来封装逻辑：

public class TenantDatabaseService
{
    private readonly TenantDbContext _tenantDbContext;
    private readonly IConfiguration _configuration;

    public TenantDatabaseService(TenantDbContext tenantDbContext, IConfiguration configuration)
    {
        _tenantDbContext = tenantDbContext;
        _configuration = configuration;
    }

    public async Task CreateTenantDatabaseAsync(string tenantName)
    {
        // 双重验证租户名称唯一性（避免并发场景下的冲突）
        var existingTenant = await _tenantDbContext.Tenants.FirstOrDefaultAsync(t => t.TenantName == tenantName);
        if (existingTenant != null)
        {
            throw new InvalidOperationException("租户名称已存在");
        }

        // 生成租户数据库的连接字符串（基于公共库连接串修改数据库名）
        var commonConnStr = _configuration.GetConnectionString("TenantCommonDb");
        var connBuilder = new SqlConnectionStringBuilder(commonConnStr);
        // 给租户库加前缀，避免与系统库重名，同时过滤非法字符
        var safeDbName = $"Tenant_{Regex.Replace(tenantName, @"[^a-zA-Z0-9_]", "")}";
        connBuilder.InitialCatalog = safeDbName;
        var tenantConnStr = connBuilder.ToString();

        // 执行SQL创建数据库（用原始连接执行，不需要上下文）
        using var connection = new SqlConnection(commonConnStr);
        var createDbSql = $"IF NOT EXISTS (SELECT * FROM sys.databases WHERE name = N'{safeDbName}') CREATE DATABASE [{safeDbName}]";
        await connection.OpenAsync();
        using var command = new SqlCommand(createDbSql, connection);
        await command.ExecuteNonQueryAsync();

        // 把租户信息存入公共库
        var tenant = new Tenant { TenantName = tenantName };
        _tenantDbContext.Tenants.Add(tenant);
        await _tenantDbContext.SaveChangesAsync();

        // 为租户数据库生成业务表结构
        await InitializeTenantTablesAsync(tenantConnStr);
    }

    private async Task InitializeTenantTablesAsync(string tenantConnStr)
    {
        // 创建租户专属上下文，生成表结构
        var options = new DbContextOptionsBuilder<TenantDataDbContext>()
            .UseSqlServer(tenantConnStr)
            .Options;

        using var tenantDbContext = new TenantDataDbContext(options);
        // 方法1：用EnsureCreated快速生成表（适合初始创建，但不支持后续EF迁移）
        await tenantDbContext.Database.EnsureCreatedAsync();

        // 方法2：如果需要后续支持模型变更的迁移，改用以下代码
        // await tenantDbContext.Database.MigrateAsync();
    }
}

记得把这个服务注册到依赖注入容器：

builder.Services.AddScoped<TenantDatabaseService>();

3. 租户业务数据上下文 #

创建专门用于存储Product和Sales的EF上下文，对应每个租户的独立数据库：

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

    // 你的业务实体集合
    public DbSet<Product> Products { get; set; }
    public DbSet<Sales> Sales { get; set; }

    // 可选：配置表名、字段约束等
    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity<Product>().ToTable("Products");
        modelBuilder.Entity<Sales>().ToTable("Sales");
    }
}

// 你的业务实体类
public class Product { public int Id { get; set;} public string Name { get; set;} }
public class Sales { public int Id { get; set;} public string Name { get; set;} }

4. 关键注意事项 #

• 数据库名称合法性：租户名称可能包含非法字符，创建前一定要做过滤，只允许字母、数字、下划线这类合法字符
• 权限配置：运行应用的账户（比如IIS应用池账户）需要有SQL Server的数据库创建权限，否则会执行失败
• 迁移管理：如果后续需要修改业务模型，建议提前为TenantDataDbContext创建迁移文件，然后用MigrateAsync()替代EnsureCreatedAsync()，这样后续模型变更可以通过迁移脚本同步到所有租户库
• 连接字符串安全：不要硬编码敏感信息，始终用配置文件或密钥管理器存储连接串

内容的提问来源于stack exchange，提问作者Kgn-web