为何Entity Framework Core生成外键约束时使用类名而非表名？

模型代码 #

RelationTypeModel #

internal class RelationTypeModel
{
    public Guid Id { get; init; }
    public required string Name { get; init; }

    public class Configurator : IEntityTypeConfiguration<RelationTypeModel>
    {
        public void Configure(EntityTypeBuilder<RelationTypeModel> builder)
        {
            builder.ToTable("graph_relation_types");
            builder.Property(r => r.Id)
                .HasColumnName("relation_type_id")
                .HasValueGenerator<Guid7ValueGenerator>();
        }
    }
}

GraphRelationModel #

internal class GraphRelationModel
{
    public Guid Id { get; init; }
    public Guid RelationTypeId { get; init; }
    public virtual RelationTypeModel? RelationType { get; init; }

    public class Configurator : IEntityTypeConfiguration<GraphRelationModel>
    {
        public void Configure(EntityTypeBuilder<GraphRelationModel> builder)
        {
            builder
                .ToTable("graph_relations");

            builder.Property(r => r.Id)
                .HasColumnName("graph_relation_id")
                .HasValueGenerator<Guid7ValueGenerator>();

            builder.Property(r => r.RelationTypeId)
                .HasColumnName("relation_type_id");
        }
    }
}

数据库上下文代码（PostgreSQL） #

internal class DatabaseContext : DbContext
{
    public DatabaseContext()
        : base()
    {
    }

    public DatabaseContext(DbContextOptions<DatabaseContext> options)
        : base(options)
    {
    }

    protected override void OnConfiguring(DbContextOptionsBuilder options)
    {
        options
            .UseSnakeCaseNamingConvention()
            .UseLazyLoadingProxies();

        options.EnableSensitiveDataLogging(true);
    }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.ApplyConfigurationsFromAssembly(GetType().Assembly);
    }

    protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
    {
        // 移除数据注解相关约定以提升模型构建性能（参考EF Core文档建议）
        var types = typeof(BackingFieldAttributeConvention).Assembly
            .GetTypes()
            .Where(type => type.Name.EndsWith("AttributeConvention"));

        foreach (var conventionType in types)
            configurationBuilder.Conventions.Remove(conventionType);
    }
}

问题现象 #

给模型添加构造函数后，通过CLI命令 dotnet ef migrations add --context "DatabaseContext" test 生成迁移，发现模型快照中的外键约束名发生异常变更：原本基于表名的正确命名被EF Core改回基于类名的形式，不符合预期，只能手动指定约束名来避免后续出现同类问题。

原因分析 #

1. 约定移除操作破坏约束命名逻辑：在ConfigureConventions中批量移除所有以AttributeConvention结尾的约定，操作过于宽泛，误删了与外键约束名生成相关的必要约定依赖逻辑，导致EF Core无法根据表名生成约束名。
2. 模型元数据重新计算的影响：添加构造函数后，EF Core会重新构建模型元数据。此时如果没有显式配置外键约束名，EF Core会基于当前生效的约定重新生成名称——由于之前的约定被破坏，只能回退到使用类名作为默认命名来源。
3. 蛇形命名约定的局限性：UseSnakeCaseNamingConvention()主要负责表名、列名的蛇形转换，但外键约束名的生成依赖独立的关系命名约定，前者无法覆盖后者的逻辑。

解决建议 #

• 显式指定外键约束名：在GraphRelationModel的配置类中添加外键约束名的显式配置，确保命名稳定：

builder.HasOne(r => r.RelationType)
       .WithMany() // 根据实际关系调整，若为一对多需指定对应集合属性
       .HasForeignKey(r => r.RelationTypeId)
       .HasConstraintName("fk_graph_relations_relation_type_id");

• 优化约定移除逻辑：避免批量删除所有AttributeConvention，仅移除明确不需要的特定约定。比如如果只是想移除数据注解相关的约定，针对性删除即可，不要影响关系命名相关的核心约定。

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