使用Database.EnsureCreated()创建外键时失败的问题求助

我在Docker镜像中创建测试数据库，在Startup.cs中添加了以下代码：

if (env.IsDevelopment())
{
    using var scope = app.ApplicationServices.CreateScope();
    Application.SetupContext(scope.ServiceProvider);
    using var context = scope.ServiceProvider.GetRequiredService<MyDbContext>();
    context.Database.EnsureDeletedAsync().Wait();
    context.Database.EnsureCreatedAsync().Wait();
    SqliteDbSeeder.SeedTestDatabase(context);
}

创建Addresses表时抛出异常，执行的SQL命令如下：

CREATE TABLE [Addresses] (
    [Id] int NOT NULL,
    [CareOf] nvarchar(500) NULL,
    [Address] nvarchar(500) NULL,
    [AptSte] nvarchar(255) NULL,
    [City] nvarchar(255) NULL,
    [StateProvince] nvarchar(255) NULL,
    [ZipPostalCode] nvarchar(10) NULL,
    [Country] nvarchar(255) NULL,
    CONSTRAINT [PK_dbo.ContactMechanisms] PRIMARY KEY ([Id]),
    CONSTRAINT [FK_Addresses_ContactMechanisms_Id] FOREIGN KEY ([Id]) REFERENCES [ContactMechanisms] ([Id])
);

错误提示：

There is already an object named 'PK_dbo.ContactMechanisms' in the database.

背景：我有一个ContactMechanism基类实体，被PhoneNumber、Address等子类继承。EF Core自动生成的约束名被多个表复用，导致冲突。我尝试过以下方法但无效：

• 给Address配置主键名：entity.HasKey(e => e.Id).HasName("PK_dbo.Addresses");，报错：A key cannot be configured on 'Address' because it is a derived type. The key must be configured on the root type 'ContactMechanism'
• 显式指定继承关系：modelBuilder.Entity<Address>().HasBaseType<ContactMechanism>();，仍出现原错误

注：数据库设计无法修改，求解决方法。

解决方案 #

1. 显式修改派生表主键约束元数据

EF Core不允许直接在派生类上配置主键，但可以通过修改模型元数据的方式，为每个派生表指定唯一的主键约束名：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 配置基类主键
    modelBuilder.Entity<ContactMechanism>()
        .HasKey(c => c.Id);

    // 为Address表设置专属主键约束名
    var addressEntity = modelBuilder.Entity<Address>();
    addressEntity.HasBaseType<ContactMechanism>();
    addressEntity.Metadata.FindPrimaryKey()
        .SetName("PK_dbo.Addresses");

    // 为PhoneNumber表同理配置
    var phoneNumberEntity = modelBuilder.Entity<PhoneNumber>();
    phoneNumberEntity.HasBaseType<ContactMechanism>();
    phoneNumberEntity.Metadata.FindPrimaryKey()
        .SetName("PK_dbo.PhoneNumbers");
}

2. 自定义约定批量处理所有派生表

如果有大量派生类，可以创建自定义约定，自动为每个TPT（Table Per Type）派生表生成唯一主键约束名：

public class UniquePrimaryKeyNameConvention : IModelFinalizingConvention
{
    public void ProcessModelFinalizing(IConventionModelBuilder modelBuilder, IConventionContext<IConventionModelBuilder> context)
    {
        foreach (var entityType in modelBuilder.Model.GetEntityTypes())
        {
            // 仅处理TPT模式下的派生类
            if (entityType.BaseType != null && entityType.GetTableName() != entityType.BaseType.GetTableName())
            {
                var primaryKey = entityType.FindPrimaryKey();
                if (primaryKey != null)
                {
                    var tableName = entityType.GetTableName();
                    primaryKey.SetName($"PK_dbo.{tableName}");
                }
            }
        }
    }
}

// 在OnModelCreating中注册约定
protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.HasAnnotation(CoreAnnotationNames.Conventions, new List<IConvention>
    {
        new UniquePrimaryKeyNameConvention()
    });

    // 其他模型配置...
}

3. 验证效果

重新运行初始化代码后，EF Core生成的SQL会为每个派生表使用专属的主键约束名，避免重复冲突。

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