EF Core 6.0使用TPT继承时自定义主键约束名问题咨询

首先明确报错原因：EF Core继承体系中，主键被定义为根实体层级的属性，默认不允许在派生实体中直接配置主键，因此你在DerivedItemConfiguration中配置主键会触发对应错误。

可行解决方案 #

方案1：手动编辑迁移文件（快速适配单次迁移） #

这是最轻量化的实现方式，无需修改现有模型配置，操作步骤如下：

1. 先删除DerivedItemConfiguration中配置主键的代码，保留BaseItemConfiguration的主键配置
2. 正常执行脚手架命令生成初始迁移文件
3. 打开生成的迁移文件，找到DerivedItems表的创建逻辑，手动修改主键约束的name参数即可：

// 迁移文件中的DerivedItems表创建代码示例
constraints: table =>
{
    // 将默认生成的PK_DerivedItems修改为你需要的PK_dbo.DerivedItems
    table.PrimaryKey("PK_dbo.DerivedItems", x => x.ID);
    // 也可同步修改关联的外键约束名
    table.ForeignKey(
        name: "FK_DerivedItems_BaseItems_ID",
        column: x => x.ID,
        principalTable: "BaseItems",
        principalColumn: "ID",
        onDelete: ReferentialAction.Cascade);
});

注意：此方案每次生成涉及TPT表结构变更的迁移时，都需要手动检查修改约束名，适合实体数量少、迁移频次低的场景。

方案2：自定义模型约定批量配置（长期适配多实体场景） #

如果需要适配大量派生实体，不想每次手动修改迁移，可以通过实现EF Core的模型最终构建约定，自动为所有TPT派生表生成指定规则的主键名：

1. 首先删除DerivedItemConfiguration中配置主键的代码，保留BaseItemConfiguration的主键配置
2. 实现自定义主键命名约定类：

using Microsoft.EntityFrameworkCore.Metadata.Builders;
using Microsoft.EntityFrameworkCore.Metadata.Conventions;

public class TptPrimaryKeyNamingConvention : IModelFinalizingConvention
{
    public void ProcessModelFinalizing(IConventionModelBuilder modelBuilder, IConventionContext<IConventionModelBuilder> context)
    {
        // 遍历所有映射了表的派生实体
        foreach (var entityType in modelBuilder.Metadata.GetEntityTypes())
        {
            if (entityType.BaseType != null && entityType.GetTableName() != null)
            {
                var primaryKey = entityType.FindPrimaryKey();
                if (primaryKey != null)
                {
                    // 按你需要的规则生成主键名，此处示例为PK_dbo.表名
                    primaryKey.SetName($"PK_dbo.{entityType.GetTableName()}");
                }
            }
        }
    }
}

3. 在DbContext中注册该约定：

protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
{
    configurationBuilder.Conventions.Add(_ => new TptPrimaryKeyNamingConvention());
}

配置完成后重新生成迁移，所有TPT派生表的主键约束名就会自动按你定义的规则生成。

补充说明 #

如果你后续升级到EF Core 7及以上版本，可以直接通过Fluent API的HasName方法针对特定表配置主键名，无需额外约定。

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