如何在EF Core 7+中覆盖多对多关联表的外键列名约定？

问题场景 #

当使用EF Core 7的无实体多对多关联配置时，默认生成的中间表外键列名会以导航属性名+Id命名（比如示例中的BooksWrittenId和ContributingAuthorsId）。如果希望统一使用实体名+Id（如BookId、AuthorId），无需逐个手动修改列名，可以用以下两种更优雅的方案。

方案一：关联配置时直接指定列名 #

在配置多对多关联的UsingEntity方法中，直接定义中间表的外键列名，无需事后修改：

modelBuilder.Entity<Book>()
    .HasMany(book => book.ContributingAuthors)
    .WithMany(author => author.BooksWritten)
    .UsingEntity("AuthorBookCrossReference",
        // 配置指向Author的外键列名
        j => j.HasOne<Author>().WithMany().HasForeignKey("AuthorId"),
        // 配置指向Book的外键列名
        j => j.HasOne<Book>().WithMany().HasForeignKey("BookId"));

这种方式针对性强，适合需要单独配置某一个多对多关联的场景。

方案二：全局自定义Model Building Convention #

通过EF Core 7的Model Building Conventions机制，实现全局统一的列名规则，所有多对多中间表都会自动应用该规则：

1. 自定义约定类 #

public class ManyToManyJoinTableForeignKeyConvention : IEntityTypeAddedConvention
{
    public void ProcessEntityTypeAdded(IConventionEntityTypeBuilder entityTypeBuilder, IConventionContext<IConventionEntityTypeBuilder> context)
    {
        // 仅处理无CLR实体类型的多对多中间表
        if (entityTypeBuilder.Metadata.IsKeyless || entityTypeBuilder.Metadata.ClrType != null)
            return;

        foreach (var foreignKey in entityTypeBuilder.Metadata.GetForeignKeys())
        {
            var principalEntityName = foreignKey.PrincipalEntityType.ShortName();
            var targetColumnName = $"{principalEntityName}Id";
            
            // 修改外键约束名和列名
            foreignKey.Builder.HasConstraintName(targetColumnName);
            foreach (var property in foreignKey.Properties)
            {
                property.Builder.HasColumnName(targetColumnName);
            }
        }
    }
}

2. 注册自定义约定 #

在DbContext的ConfigureConventions方法中添加该约定：

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

此后所有通过UsingEntity(string)创建的无实体多对多中间表，都会自动使用实体名+Id作为外键列名，无需重复配置。

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