EF Core 9.0.3：关联对象字段命名引发外键误绑定问题

这是EF Core的**约定优先（Convention over Configuration）**机制导致的，你忽略了EF Core的外键命名规范。

核心原因 #

EF Core自动识别一对多关系时，会遵循外键命名约定：当实体中存在[主实体名称]Id格式的字段时（这里主实体是User，对应字段UserId），EF会默认将该字段认定为关联User实体的外键——哪怕User的主键是Username而非Id。这就是为什么你的UserId字段被复用为外键，原有赋值被覆盖；而改名为DatabaseUser后，不符合这个命名规则，EF就会自动创建新的外键列（默认用Username作为列名，因为User的主键是Username）。

解决方案 #

根据需求选择以下两种方式：

1. 显式配置关联外键，保留UserId作为独立字段

在OnModelCreating中修改关系配置，明确指定关联的外键列名（让EF自动创建该列，而非复用UserId）：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<User>()
        .HasMany(u => u.Connections)
        .WithOne()
        .HasForeignKey("Username") // 显式指定外键列名为Username，EF会自动生成该列
        .OnDelete(DeleteBehavior.Cascade);
    
    modelBuilder.Entity<User>()
        .Navigation(u => u.Connections)
        .AutoInclude();
    // 其他配置...
}

修改后，EF会在DBConnectors表中同时生成UserId（你的独立字段）和Username（关联外键）两个列，互不干扰。

2. 修改独立字段名称（已验证可行）

继续使用你测试过的方案，将DBConnector中的UserId改为非[主实体名]Id格式的名称（比如DatabaseUser），这样EF不会将其识别为外键，会自动创建关联所需的外键列。

补充说明 #

如果需要更精细化控制，推荐用Fluent API（即OnModelCreating中的配置）明确关系，避免数据注解带来的耦合。

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