EF Core 3.1 Database First移除表关联后查询报Invalid column name 'VehicleId'错误

问题根本原因 #

你遇到的报错是EF Core生成的查询语句中仍然包含了VehicleId字段，哪怕你已经删除了Calculation实体的对应属性和显式关联配置，最常见的触发原因如下：

1. 项目编译缓存未清理，旧的上下文构建逻辑仍然生效
2. 你只删除了Calculation实体一侧的关联配置，遗漏了Vehicle实体配置中的反向关联定义。只要Vehicle的FluentAPI配置中还存在HasMany(x => x.Calculations).WithOne(...)这类关联语句，EF Core会按照约定自动生成名为VehicleId的影子外键属性，查询时自动带上该字段，就会触发数据库端的字段不存在错误
3. 上下文的全局模型约定、全局查询过滤器中存在残留的VehicleId相关配置
4. Calculation的partial类的另一半定义中，残留了VehicleId属性或者Vehicle导航属性

排查解决步骤 #

• 先彻底清理项目缓存：关闭IDE，删除解决方案根目录下的bin、obj文件夹，重启IDE后重新编译整个项目
• 全局搜索整个解决方案的VehicleId、Calculation关键字，重点检查Vehicle实体的FluentAPI配置，删除所有和Calculation相关的关联定义
• 检查上下文的OnModelCreating方法中是否有全局配置、自定义约定逻辑涉及到Vehicle和Calculation的关联，全部清理
• 临时在上下文的OnConfiguring方法中禁用服务缓存，验证是否是模型缓存导致的问题：

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
    optionsBuilder.EnableServiceProviderCaching(false);
    // 保留你原有的其他配置
}

如果嫌排查麻烦，重新生成独立的上下文确实是最高效的解决方案，能完全避免旧配置残留的问题。

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