.NET EF Core查询PostgreSQL时出现不存在的影子外键列问题

问题原因 #

注释掉UserVisual实体的UserOld导航属性后，DbContext中仍保留着该影子外键（UserOldId）的配置，EF Core生成查询时依然会引用这个不存在的列，导致PostgreSQL报错。

解决步骤 #

• 清理上下文的影子外键配置
  找到DbContext中OnModelCreating方法里针对UserVisual实体配置UserOld关联的代码段，删除所有涉及UserOldId影子外键的配置。比如删除类似以下代码：

  modelBuilder.Entity<UserVisual>()
      .HasOne(u => u.UserOld)
      .WithMany()
      .HasForeignKey("UserOldId");
  

• 验证模型元数据
  调试时可输出模型元数据，确认UserVisual实体已不再包含UserOldId影子属性。示例代码：

  var userVisualEntity = context.Model.GetEntityTypes()
      .First(t => t.ClrType == typeof(UserVisual));
  var properties = userVisualEntity.GetProperties().Select(p => p.Name);
  // 检查properties中是否存在UserOldId，确保已移除
  

• 处理数据库迁移（Code First场景）
  若使用Code First，生成新迁移同步模型与数据库结构：

  1. 运行迁移命令：

     Add-Migration RemoveUserOldIdShadowColumn
     

  2. 打开生成的迁移文件，若数据库中实际不存在UserOldId列，手动移除迁移文件中删除该列的操作（避免执行时报错）。
  3. 更新数据库：

     Update-Database
     

• 重启应用清理缓存
  EF Core会缓存模型元数据，重启应用确保新的模型配置生效，避免旧配置残留导致查询错误。

额外注意 #

• 若存在反向导航属性的配置（比如UserOld实体中关联UserVisual的配置），也要同步清理。
• 若是Database First模式，需重新生成实体类和DbContext，保证模型与数据库结构完全匹配。

内容的提问来源于stack exchange，提问作者Kęstutis Ramulionis