如何使用EF Core处理多站点SQL Server数据库列类型变化的适配问题

你遇到的场景完全可以通过EF Core原生能力解决，不需要修改数据库，也不需要维护多版本API。

EF Core 2.2版本适配方案 #

EF Core 2.1及以上版本就原生支持**值转换器（Value Converter）**功能，刚好覆盖你使用的2.2版本，操作步骤如下：

1. 统一实体属性类型
   将所有存在类型差异的字段的C#实体属性统一设置为int类型，int的取值范围完全覆盖TINYINT的0-255区间，不会出现取值溢出问题。
2. 配置值转换器
   由于你使用Database First模式，不要修改自动生成的模型和DbContext代码，通过partial类扩展实现自定义配置，避免后续脚手架生成时配置被覆盖：

• 首先创建单独的实体配置类实现IEntityTypeConfiguration<T>接口，给差异字段配置转换器：

using Microsoft.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore.Metadata.Builders;

// 和自动生成的实体类同名的partial类配置
public partial class 你的实体类名Configuration : IEntityTypeConfiguration<你的实体类名>
{
    public void Configure(EntityTypeBuilder<你的实体类名> builder)
    {
        // 存在类型差异的字段配置转换器，Convert.ToInt32可同时兼容数据库返回的byte(TINYINT)和int(INT)类型
        builder.Property(e => e.差异字段名)
            .HasConversion(
                writeValue => writeValue, // 只读场景下写入逻辑无需特殊处理
                readValue => Convert.ToInt32(readValue)
            );
        // 其余差异字段按相同规则添加配置即可
    }
}

• 扩展自动生成的DbContext为partial类，在OnModelCreating中加载自定义配置：

using Microsoft.EntityFrameworkCore;

public partial class 你的DbContext类名
{
    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        // 调用自动生成的基础配置
        base.OnModelCreating(modelBuilder);
        // 加载自定义的实体配置
        modelBuilder.ApplyConfiguration(new 你的实体类名Configuration());
        // 如有多个实体配置，可直接用modelBuilder.ApplyConfigurationsFromAssembly(typeof(你的DbContext类名).Assembly)批量扫描加载
    }
}

更高版本EF Core（3.0+）优化方案 #

更高版本的EF Core支持批量配置值转换器，无需逐个字段手动配置，适合差异字段较多的场景，示例如下：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    base.OnModelCreating(modelBuilder);
    // 批量给所有int类型的实体属性配置通用转换器，自动适配TINYINT/INT类型差异
    foreach (var entityType in modelBuilder.Model.GetEntityTypes())
    {
        foreach (var property in entityType.GetProperties())
        {
            if (property.ClrType == typeof(int))
            {
                property.SetValueConverter(new ValueConverter<int, object>(
                    v => v,
                    v => Convert.ToInt32(v)
                ));
            }
        }
    }
}

注意事项 #

• 你当前是只读场景，无需考虑写入兼容性问题；如果后续需要写入数据，只要字段取值不超过TINYINT的0-255上限，SQL Server会自动完成类型转换，不会出现报错。
• 该方案无需修改数据库结构，也不需要维护多版本API，相比存储过程方案工程量极小，仅需一次配置即可全局生效。

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