Entity Framework Core生成数据库时Users表出现意外TestRequestId列问题

需求说明 #

需要构建TestRequests和Users表的关联：

• 一个User可以作为多个TestRequest的Author
• 一个TestRequest仅对应一个Author
• 使用EF Core 7.0.11版本

实体类代码 #

public class TestRequest
{
    public int Id { get; set; }
    public string Title { get; set; }
    public string Description { get; set; }
    public TestRequestStatus Status { get; set; }
    public List<Signature> Signatures { get; set; }
    public List<Device> Devices { get; set; }
    public List<ItemNumber> ItemNumbers { get; set; }
    public List<SerialNumber> SerialNumbers { get; set; }
    public List<Norm> Norms { get; set; }
    public List<User> Developers { get; set; }
    public User Author { get; set; }

    public ICollection<CommentaryModel> Comments { get; set; } = new List<CommentaryModel>();
}

public class User
{
    public int Id { get; set; }
    public string UserName { get; set; }
    public string LastName { get; set; }
    public string FirstName { get; set; }
    public string Email { get; set; }
    public AuthorizationStatus AuthorizationStatus { get; set; }
    public string AuthorizationMessage { get; set; }
    public User AuthorizationByUser { get; set; }
    public Role Role { get; set; }
    public List<TestRequest> TestRequests { get; set; }
}

DbContext配置 #

// ...
public DbSet<TestRequest> TestRequests { get; set; }
public DbSet<User> Users { get; set; }
// ...

问题现象 #

预期Users表无TestRequests相关外键，TestRequests表应生成指向User的AuthorId外键，但实际生成的Users表多出TestRequestId列，迁移代码片段如下：

migrationBuilder.CreateTable(
    name: "Users",
    columns: table => new
    {
        Id = table.Column<int>(type: "int", nullable: false)
            .Annotation("SqlServer:Identity", "1, 1"),
        UserName = table.Column<string>(type: "nvarchar(max)", nullable: false),
        LastName = table.Column<string>(type: "nvarchar(max)", nullable: false),
        FirstName = table.Column<string>(type: "nvarchar(max)", nullable: false),
        Email = table.Column<string>(type: "nvarchar(max)", nullable: false),
        AuthorizationStatusId = table.Column<int>(type: "int", nullable: false),
        AuthorizationMessage = table.Column<string>(type: "nvarchar(max)", nullable: false),
        AuthorizationByUserId = table.Column<int>(type: "int", nullable: false),
        RoleId = table.Column<int>(type: "int", nullable: false),
        TestRequestId = table.Column<int>(type: "int", nullable: true)
    },
    constraints: table =>
    {
        table.PrimaryKey("PK_Users", x => x.Id);
        // 其他外键约束略...
        table.ForeignKey(
            name: "FK_Users_TestRequests_TestRequestId",
            column: x => x.TestRequestId,
            principalTable: "TestRequests",
            principalColumn: "Id");
    });

原因分析 #

EF Core的约定配置无法自动推断关联关系的对应项：

• TestRequest类中有两个与User相关的导航属性：Author（一对多）和Developers（多对多）
• User类中的List<TestRequest> TestRequests集合，EF无法确定它对应TestRequest的哪个导航属性，因此错误生成了反向的一对多关联（将User作为从属端，TestRequest作为主体端），导致Users表出现TestRequestId外键。

解决方法 #

在DbContext的OnModelCreating方法中使用Fluent API显式配置关联关系，明确映射导航属性的对应关系：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 配置Author的一对多关系：User.TestRequests对应TestRequest.Author
    modelBuilder.Entity<TestRequest>()
        .HasOne(tr => tr.Author)
        .WithMany(u => u.TestRequests)
        .HasForeignKey("AuthorId") // 指定TestRequests表的外键列名，可省略让EF自动生成
        .OnDelete(ReferentialAction.Restrict); // 根据业务需求设置删除行为

    // 配置Developers的多对多关系
    modelBuilder.Entity<TestRequest>()
        .HasMany(tr => tr.Developers)
        .WithMany() // 如果User端不需要对应集合，使用空的WithMany()
        .UsingEntity(j => j.ToTable("TestRequestDevelopers")); // 指定多对多中间表名称
}

配置完成后，删除现有迁移、重新生成迁移并更新数据库即可得到预期的表结构。

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