C# EF Core Code-First模式下从DbContext.Table生成List遇错求解

架构老林

2026-7-18

解决EF Core Code-First中查询Citizen列表时的“Invalid column name 'LicenseID'”错误

这个错误的核心原因是：EF Core生成的SQL语句尝试引用LicenseID列，但数据库的Citizen表中不存在该列，或者实体映射与实际数据库列名不匹配。以下是具体的解决步骤：

检查数据库表结构
直接查看数据库（如SQL Server Management Studio）中的Citizen表：
- 若表中列名为LicenseId（与实体类属性名一致），则你在OnModelCreating中配置的HasColumnName("LicenseID")是多余的，需要删除。
- 若表中列名确实是LicenseID，则需确认数据库迁移是否正确执行，确保实体映射与数据库结构同步。
修正实体映射配置
- 如果数据库列名是LicenseId，修改OnModelCreating中的Citizen配置，移除强制指定列名的代码，让EF Core使用默认的属性-列名映射：
```
modelBuilder.Entity<Citizen>(entity => {
    entity.HasOne(d => d.license).WithMany(p => p.Citizens)
          .HasForeignKey(d => d.LicenseId)
          .OnDelete(DeleteBehavior.ClientSetNull);
});
```
- 如果数据库列名确实是LicenseID，但数据库未同步映射配置，执行以下迁移命令更新数据库：
```
Add-Migration FixLicenseColumnName
Update-Database
```
检查关联实体配置
确保DriversLicense实体中存在对应的导航属性Citizens，否则EF Core可能生成错误的外键约束：
```
public class DriversLicense
{
    // 其他属性
    public virtual ICollection<Citizen> Citizens { get; set; }
}
```
验证查询代码
你的查询代码context.Citizen.ToList()本身无问题，修复映射与数据库结构的匹配问题后，重新运行即可正常生成列表。