使用NuGet包报Core SqlClient无效列错误但包内测试运行正常

问题原因 #

这个问题的核心是EF Core的外键约定未生效，导致生成了不符合预期的SQL查询字段名，具体可以拆为两点说明：

1. 内存SQLite测试正常的原因：
   内存SQLite在测试场景下由EF Core动态生成表结构，就算外键配置存在瑕疵，EF Core也会自动根据代码里的实体关联逻辑生成对应字段，不会出现字段找不到的问题。而真实SQL数据库的表结构是预先创建的，只有你手动定义的PlatformQuizConfigurationId字段，没有EF Core按默认约定生成的字段，因此触发报错。
2. 外键约定失效的常见原因：

• 你使用的[ForeignKey]特性引用了错误的命名空间，不是EF Core官方的System.ComponentModel.DataAnnotations.Schema下的特性，导致EF Core没有识别到外键配置，只能按照默认规则，用导航属性的类名PlatformQuizConfigurationEntity加Id拼接出外键名PlatformQuizConfigurationEntityId。
• 你的NuGet包项目和Azure Functions项目引用的EF Core版本差异过大，不同版本的EF Core对特性的识别逻辑、模型约定规则存在差异，导致配置失效。
• 你没有在DbContext的OnModelCreating方法中显式配置实体关联，仅靠特性的配置在部分场景下会因为上下文的模型扫描规则异常而失效。

修复方案 #

你可以任选下面一种方案修复，优先推荐第一种，稳定性最高：

1. 显式在OnModelCreating中配置外键关联
   在你的DbContext的OnModelCreating方法中添加如下配置，强制指定外键关联，绕过特性识别可能出现的问题：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 其他现有配置...
    modelBuilder.Entity<PlatformEnrollmentEntity>()
        .HasOne(p => p.PlatformQuizConfiguration)
        .WithMany() // 如果PlatformQuizConfigurationEntity中存在对应PlatformEnrollments的导航属性，替换为.WithMany(x => x.PlatformEnrollments)即可
        .HasForeignKey(p => p.PlatformQuizConfigurationId)
        .IsRequired();
    
    // 建议其他导航属性也按同样方式显式配置，避免后续出现类似问题
    modelBuilder.Entity<PlatformEnrollmentEntity>()
        .HasOne(p => p.PlatformEnrollmentStatus)
        .WithMany()
        .HasForeignKey(p => p.PlatformEnrollmentStatusId)
        .IsRequired();
    
    modelBuilder.Entity<PlatformEnrollmentEntity>()
        .HasOne(p => p.PlatformEnrollmentDeliveryEntity)
        .WithMany()
        .HasForeignKey(p => p.PlatformEnrollmentDeliveryId)
        .IsRequired();
}

2. 修正特性配置并统一EF Core版本

• 检查所有[ForeignKey]特性的命名空间，确保引用的是using System.ComponentModel.DataAnnotations.Schema;
• 双向标注外键关联，提升识别优先级：

[ForeignKey(nameof(PlatformQuizConfiguration))]
public int PlatformQuizConfigurationId { get; set; }
public PlatformQuizConfigurationEntity PlatformQuizConfiguration { get; set; }

• 统一NuGet包项目和Azure Functions项目的EF Core版本，保持为同一个大版本的最新稳定版即可。

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