EF Core 7：集合导航属性实体表名未自动复数化如何解决

实体类定义 #

public class Project
{
    public int Id { get; set; }
    
    public List<Issue> Issues { get; set; } = new();
}

public class Issue
{
    public int Id { get; set; }

    public Project Project { get; set; } = null!;
}

DbContext定义 #

internal class AppDbContext : DbContext
{
    public DbSet<Project> Projects { get; set; }

    /// <inheritdoc />
    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        base.OnConfiguring(optionsBuilder);

        optionsBuilder.UseNpgsql("Server=127.0.0.1;Port=5432;Database=testapp;User Id=postgres;Password=postgres;");
    }
}

问题现象 #

执行dotnet ef migrations add命令生成迁移后，Up()方法中：

• Project对应的表名为复数Projects（遵循DbSet属性名约定）
• Issue对应的表名为单数Issue（仅作为Project的集合导航属性存在，未暴露DbSet）
  导致表名命名规则不一致。

需求 #

可接受统一使用单数或复数表名，但无法容忍规则不一致的情况，希望无需手动指定（如[Table("Issues")]、modelBuilder.Entity<Issue>().ToTable("Issues")或添加DbSet<Issue> Issues { get; set; }），让EF Core自动将Issue表名复数化。

解决方案 #

EF Core默认表命名规则：

• 暴露为DbSet<T>的实体：使用DbSet属性名作为表名
• 未暴露为DbSet的实体：直接使用实体类的单数名称

要实现统一复数化，无需逐个手动指定的话，可通过自定义全局表命名约定实现：

方法1：复用EF Core内置复数化服务（推荐） #

EF Core内置IPluralizer服务，默认支持英文实体名的标准复数化。在DbContext的OnModelCreating中配置全局约定，让所有实体表名统一使用复数形式：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    base.OnModelCreating(modelBuilder);

    var pluralizer = modelBuilder.Model.GetService<IPluralizer>();
    foreach (var entityType in modelBuilder.Model.GetEntityTypes())
    {
        entityType.SetTableName(pluralizer.Pluralize(entityType.ClrType.Name));
    }
}

方法2：自定义复数化逻辑 #

如果默认复数化规则不符合需求，可手动实现自定义逻辑，比如：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    base.OnModelCreating(modelBuilder);

    foreach (var entityType in modelBuilder.Model.GetEntityTypes())
    {
        var entityName = entityType.ClrType.Name;
        // 简单复数化规则：以y结尾改为ies，其余加s
        var pluralName = entityName.EndsWith("y", StringComparison.OrdinalIgnoreCase)
            ? entityName[..^1] + "ies"
            : entityName + "s";
        entityType.SetTableName(pluralName);
    }
}

配置完成后，无论实体是否通过DbSet暴露，都会统一使用复数表名，无需逐个手动指定。

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