EF Core 5.0操作SQL Server bit类型字段保存出现TDS协议错误

1. 实体属性与数据库字段映射顺序不匹配（最高概率） #

EF Core 5.0存在已知的参数顺序映射bug，当你的表字段定义顺序和模型类的属性定义顺序不一致时，生成UPDATE语句的参数顺序会错位。你收到的异常说第4个参数@p0是无效float，实际是EF Core把给bit类型的bool值，传给了表中第四个位置的float类型字段，导致类型不匹配。

• 为什么复选框操作就正常？因为通过复选框修改后，EF Core的变更跟踪只会标记修改过的bool属性为脏，生成UPDATE语句时只传这两个修改过的参数，不会涉及到其他float字段，不会触发参数错位。
• 为什么手动赋值就报错？因为你手动创建的Order实体，所有属性都被标记为已修改，UPDATE会生成所有字段的参数，参数顺序错位刚好把bool值传到float字段的参数位置。

2. DbContext跟踪状态冲突 #

你首次添加Order用的是局部释放的DbContext，后续修改用的是全局_dbContext，直接调用Update方法附加游离态实体时，如果实体有未初始化的数值类型属性，可能会被EF Core识别为无效值。

• 方法1：显式指定字段映射顺序
  在DbContext的OnModelCreating方法中，给Order类的属性显式配置列顺序，和数据库表的字段顺序保持一致：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Order>(b =>
    {
        b.Property(o => o.Id).HasColumnOrder(1);
        b.Property(o => o.IsVATIncluded).HasColumnOrder(2); // 和实际表顺序对应
        b.Property(o => o.IsBubbleWrapUsed).HasColumnOrder(3);
        // 其他字段按表顺序依次配置
    });
}

• 方法2：更新时只标记需要修改的属性为脏
  不要直接调用Update方法，避免所有字段都参与更新：

private void btnOK_Click(object sender, RoutedEventArgs e)
{
    var trackedOrder = _dbContext.Orders.Find(OrderItem.Id);
    trackedOrder.IsVATIncluded = OrderItem.IsVATIncluded;
    trackedOrder.IsBubbleWrapUsed = OrderItem.IsBubbleWrapUsed;
    // 其他需要更新的字段逐个赋值
    _dbContext.SaveChanges();
}

• 方法3：升级EF Core版本
  这个参数顺序的bug在EF Core 6.0及以上版本已经被修复，直接升级到最新的LTS版本即可彻底解决。

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