EF Core生成外键未添加下划线引发列名无效报错如何解决

EF 6与EF Core的无显式外键的阴影（Shadow）属性外键命名约定默认不兼容：

• EF 6默认命名规则为[导航属性名]_[关联主键名]，比如示例中Model1下的Model2导航，对应外键列会被生成为Model2_Model2Id，也就是现有数据库里的列名格式。
• EF Core的默认命名规则为[导航属性名][关联主键名]，直接拼接不带下划线，所以EF Core运行时会去找Model2Model2Id列，和现有库结构不匹配，触发无效列名报错。
  你查到的“EF Core默认外键加下划线”是混淆了EF6和EF Core的规则，EF Core 3.0及以上版本默认都采用无下划线的拼接命名逻辑。

优先选全局配置方案，适配50个实体的存量场景，无需逐个修改实体代码：

• 全局对齐EF6外键命名约定
  在你的DbContext类中重写OnModelCreating方法，添加统一外键命名配置，一次配置覆盖所有实体：

  protected override void OnModelCreating(ModelBuilder modelBuilder)
  {
      // 保留你原有的其他模型配置代码
      foreach (var entityType in modelBuilder.Model.GetEntityTypes())
      {
          foreach (var foreignKey in entityType.GetForeignKeys())
          {
              // 仅处理系统自动生成的阴影外键，不影响手动显式定义的外键
              if (foreignKey.Properties.Count == 1 && foreignKey.Properties[0].IsShadowProperty())
              {
                  string navigationName = foreignKey.DependentToPrincipal?.Name;
                  string principalKeyName = foreignKey.PrincipalKey.Properties[0].Name;
                  // 按EF6规则设置列名
                  foreignKey.Properties[0].SetColumnName($"{navigationName}_{principalKeyName}");
              }
          }
      }
  }
  

  配置完成后重新生成迁移，确认迁移文件中没有列重命名、删列/加列的冗余操作，即可直接运行，不会再触发列名不匹配错误。

• 单实体单独配置（适用于仅个别外键命名不一致的场景）
  如果不想做全局配置，可以对单个导航属性用Fluent API指定外键列名，以示例中的Model1为例：

  modelBuilder.Entity<Model1>()
      .HasOne(m => m.Model2)
      .WithMany() // 若存在反向集合导航，替换为对应导航属性名
      .HasForeignKey("Model2_Model2Id") // 直接匹配现有数据库列名
      .IsRequired();
  

• 显式定义外键属性（适用于后续代码规范迭代场景）
  可以在实体类中显式声明外键属性，通过[Column]特性匹配现有列名，以Model1为例：

  // 新增显式外键属性
  [Column("Model2_Model2Id")]
  public int Model2Id { get; set; }
  // 原有导航属性保留
  public virtual Model2 Model2 { get; set; }
  

  该方式代码可读性更高，但存量实体多的情况下修改工作量较大。

注意：配置完成后一定要先生成迁移脚本核对内容，确认没有非预期的结构变更操作，再执行迁移，避免误改数据库数据。

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