如何在读取数据时忽略ValueConverter获取数据库原始值

ValueConverter本身是和实体属性的映射绑定全局生效的，没有内置临时禁用的开关，要读取数据库存储的原始字符串值，有三种可落地的实现方式，按推荐优先级排序： #

1. 同列映射无转换器的影子属性（推荐，无侵入） #

这个方案不需要修改你现有已经跑通的转换逻辑，也不会影响正常业务场景的读写：

• 在实体模型配置阶段，给存储JSON的数据库列额外映射一个string类型的影子属性，不要给这个影子属性配置任何ValueConverter
• 配置时将影子属性设置为保存时忽略，避免多属性映射同列导致的写入冲突

配置示例：

modelBuilder.Entity<YourBusinessEntity>()
    // 你原来的属性配置完全不动，保留JSON序列化转换器
    .Property(e => e.BizDataField)
    .HasConversion<YourJsonValueConverter>()
    .HasColumnName("biz_data");

// 新增影子属性映射同列，用于读取原始值
modelBuilder.Entity<YourBusinessEntity>()
    .Property<string>("RawBizData")
    .HasColumnName("biz_data")
    .ValueGeneratedNever()
    .Metadata.SetAfterSaveBehavior(PropertySaveBehavior.Ignore);

需要读取原始值的时候，通过EF.Property取影子属性的值即可，查询时EF不会对这个无转换器的属性做任何处理，直接返回数据库存储的原始字符串：

var queryResult = dbContext.Set<YourBusinessEntity>()
    .Select(e => new 
    {
        NormalBizData = e.BizDataField, // 正常走转换器，返回反序列化后的业务对象
        RawJsonString = EF.Property<string>(e, "RawBizData") // 直接返回原始存储字符串
    })
    .FirstOrDefault(t => t.Id == targetId);

2. 原生SQL直查目标列（适合临时取数场景） #

如果只是偶尔需要取原始值，不想修改现有模型配置，直接写原生SQL查询单列即可，查询标量值时EF不会触发实体属性绑定的转换器：

var rawJsonValue = dbContext.Database
    .SqlQueryRaw<string>("SELECT biz_data FROM your_biz_table WHERE Id = {0}", targetId)
    .FirstOrDefault();

注意不要查询整个实体对象，只查询需要的原始字段即可绕过转换逻辑。 #

3. 转换器内加线程级旁路开关（不推荐，有风险） #

如果必须在原有属性上控制转换逻辑，可以用AsyncLocal做线程/异步上下文级别的开关：

• 定义全局静态的AsyncLocal<bool>作为旁路标记
• 在自定义的ValueConverter数据库到实体的转换逻辑中，判断该标记，如果标记为启用，直接返回数据库读取到的原始字符串（返回类型为object完全符合API签名要求，不会报错）
• 读取原始值前打开开关，读取完成后立刻重置开关

风险提示：该方案如果异步流程中开关重置不及时，会污染同上下文后续的查询逻辑，非极端场景不建议使用。

不要尝试在运行时动态修改ValueConverter配置或者模型映射关系，EF Core的模型配置在上下文首次初始化后就会全局缓存，运行时修改不仅不会生效，还可能导致上下文实例出现不可预期的异常。

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