使用IBM.EntityFrameworkCore从Db2读取smallint字段返回值异常排查

问题背景 #

使用IBM.EntityFrameworkCore 7.0.0.200 + .NET 7开发API，从Db2查询数据时，备选键SEQ_CD（数据库类型smallint(2)，非空无默认值）始终返回1，但数据库值正确，直接执行EF生成的SQL也能得到预期结果。已尝试short/Int16类型，问题依旧。

现有上下文配置 #

modelBuilder.Entity<MyClass>(e =>
{
    e.ToTable("Table", "Schema");
    e.HasKey(k => k.Cd);
    e.HasAlternateKey(k => k.Dc);
    e.HasAlternateKey(k => k.SeqCd);

    e.Property(p => p.CD).HasColumnName("CD");
    e.Property(p => p.DT).HasColumnName("DT");
    e.Property(p => p.SEQ_CD).HasColumnName("SEQ_CD").HasColumnType("smallint(2)");
    e.Property(p => p.CD_DS).HasColumnName("CD_DS");
});

现有实体类定义 #

namespace Project.Data.Db2.Models
{
    public partial class MyClass
    {
        public string Cd { get; set; }
        public DateTime fDt { get; set; }
        public short SeqCd { get; set; }
        [JsonConverter(typeof(TrimmedWhitespaceStringConverter))] // 用于裁剪Db2字符字段的多余空格
        public string CD_DS{ get; set; }
    }
}

核心修复步骤 #

1. 修正属性名称映射不匹配
   上下文配置中存在多处实体属性与配置代码的名称不一致，这是核心问题：

   • 实体类无Dc属性，却配置了e.HasAlternateKey(k => k.Dc)，属于无效配置
   • 上下文里的p => p.CD对应实体类的Cd，p => p.DT对应实体类的fDt，名称拼写/大小写不匹配
   • 上下文里的p => p.SEQ_CD对应实体类的SeqCd，名称大小写不匹配

   修正后的上下文配置：

   modelBuilder.Entity<MyClass>(e =>
   {
       e.ToTable("Table", "Schema");
       e.HasKey(k => k.Cd);
       // 若数据库存在第二个备选键，需先在实体类中添加对应属性；否则删除此行
       // e.HasAlternateKey(k => k.Dc);
       e.HasAlternateKey(k => k.SeqCd);
   
       e.Property(p => p.Cd).HasColumnName("CD");
       e.Property(p => p.fDt).HasColumnName("DT");
       e.Property(p => p.SeqCd)
           .HasColumnName("SEQ_CD")
           .HasColumnType("smallint") // 移除(2)，Db2 smallint无需指定长度，避免映射异常
           .IsRequired(); // 明确标记非空，与数据库定义对齐
       e.Property(p => p.CD_DS).HasColumnName("CD_DS");
   });
   

2. 移除冗余的列类型指定
   Db2的smallint与.NET的short/Int16是原生匹配的，指定smallint(2)属于多余操作，可能干扰驱动的类型映射逻辑。

3. 验证备选键的数据库约束
   确认数据库中SEQ_CD确实存在唯一约束，若不存在，需删除EF Core中的HasAlternateKey(k => k.SeqCd)配置——错误的备选键配置会导致EF Core执行额外的查询逻辑，可能覆盖正确值。

4. 清理模型缓存
   删除项目的bin、obj目录，重新编译并重启API，确保新的模型配置生效（EF Core会缓存模型元数据，旧缓存可能导致配置不生效）。

额外排查手段 #

若上述操作后问题仍存在，可开启EF Core日志输出，查看查询时的结果映射细节，确认IBM驱动是否正确读取了SEQ_CD字段的值。

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