.NET EF为何自动添加后缀为1的PermissionSetId1列？

我定义了Group模型，它与GroupPermissionSet模型是一对一关联，后者包含权限配置。

Group模型代码：

public class Group
{
    public int Id { get; set; }
    public string Name { get; set; } = string.Empty;
    public string Description { get; set; } = string.Empty;

    public int? PermissionSetId { get; set; }
    public GroupPermissionSet? PermissionSet { get; set; }
}

但EF生成的迁移代码里，Groups表被自动添加了PermissionSetId1列，且外键关联指向该列：

migrationBuilder.CreateTable(
                name: "Groups",
                columns: table => new
                {
                    Id = table.Column<int>(type: "int", nullable: false)
                        .Annotation("MySql:ValueGenerationStrategy", MySqlValueGenerationStrategy.IdentityColumn),
                    Name = table.Column<string>(type: "longtext", nullable: false)
                        .Annotation("MySql:CharSet", "utf8mb4"),
                    Description = table.Column<string>(type: "longtext", nullable: false)
                        .Annotation("MySql:CharSet", "utf8mb4"),
                    PermissionSetId = table.Column<int>(type: "int", nullable: true),
                    PermissionSetId1 = table.Column<int>(type: "int", nullable: true)
                },
                constraints: table =>
                {
                    table.PrimaryKey("PK_Groups", x => x.Id);
                    table.ForeignKey(
                        name: "FK_Groups_GroupPermissionSets_PermissionSetId1",
                        column: x => x.PermissionSetId1,
                        principalTable: "GroupPermissionSets",
                        principalColumn: "Id");
                })
                .Annotation("MySql:CharSet", "utf8mb4");

我怀疑这是Bug，也可能是对.NET一对一关联的理解有误。尝试移除Group模型中的PermissionSetId属性后，问题依旧存在，特此咨询原因。

原因分析 #

这不是EF的Bug，是因为你没正确配置一对一关联的双向关系（或者单向关联的外键映射）。EF Core对一对一关联的默认约定有严格要求：

• 要么依赖实体的主键同时作为主实体的外键
• 要么明确指定导航属性对应的外键属性

你的问题大概率是GroupPermissionSet模型中也定义了指向Group的导航属性，但未配置对应的外键，导致EF无法识别你手动添加的PermissionSetId是关联外键，于是自动生成了新的PermissionSetId1列来建立关联。

比如如果你的GroupPermissionSet模型是这样的：

public class GroupPermissionSet
{
    public int Id { get; set; }
    // 其他权限配置属性
    public Group? Group { get; set; } // 存在导航属性但未指定外键
}

这种情况下，EF会认为Group.PermissionSet和GroupPermissionSet.Group是两个未关联的导航，因此自动生成额外的外键列。

解决方案 #

1. 用Fluent API明确配置关联（推荐） #

在DbContext的OnModelCreating方法中，手动指定一对一关联的外键和导航关系：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Group>()
        .HasOne(g => g.PermissionSet) // Group拥有一个PermissionSet
        .WithOne(ps => ps.Group) // 对应PermissionSet中的Group导航属性（如果没有则去掉此句）
        .HasForeignKey<Group>(g => g.PermissionSetId); // 指定外键为PermissionSetId
}

2. 用数据注解指定外键（单向关联场景） #

如果GroupPermissionSet中没有指向Group的导航属性，可在Group模型中用[ForeignKey]注解明确外键与导航属性的对应关系：

public class Group
{
    public int Id { get; set; }
    public string Name { get; set; } = string.Empty;
    public string Description { get; set; } = string.Empty;

    [ForeignKey(nameof(PermissionSet))]
    public int? PermissionSetId { get; set; }
    public GroupPermissionSet? PermissionSet { get; set; }
}

3. 依赖主键作为外键（适合强绑定的一对一关系） #

如果GroupPermissionSet必须依赖Group存在，可让GroupPermissionSet的主键同时作为外键关联Group的Id，此时Group模型中不需要PermissionSetId：

public class GroupPermissionSet
{
    public int Id { get; set; } // 此Id同时是Group的外键
    public Group? Group { get; set; }
    // 其他权限配置属性
}

EF会自动识别这种约定，不会生成额外列，但此设计仅适用于PermissionSet无法独立存在的业务场景。

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