You need to enable JavaScript to run this app. Dapper使用动态参数传入JsonElement触发NotSupportedException异常
优惠活动
大模型
产品
解决方案
定价
更多

Dapper使用动态参数传入JsonElement触发NotSupportedException异常

问题本质

异常抛出的核心原因是:QueryFilterItem 的 Value 字段是 object 类型,ASP.NET Core 用 System.Text.Json 反序列化请求时,会把这类无明确类型的 JSON 值统一解析为 System.Text.Json.JsonElement,而 Dapper 原生无法识别 JsonElement 作为数据库参数,直接抛出不支持的异常。
从你提供的参数示例也能对应上:实际传入的 MyFilterItemEntityId 是一个值类型为 String 的 JsonElement 对象,不是直接的字符串或 Guid 原生类型。

可落地的解决方案

方案1:反序列化阶段直接把 JsonElement 转成原生类型(全局生效)

自定义 Object 类型的 Json 转换器,在接口接收到请求、反序列化的环节就把 JsonElement 替换成实际的 CLR 类型:

  1. 新增转换器类:
using System.Text.Json;
using System.Text.Json.Serialization;

public class ObjectPrimitiveConverter : JsonConverter<object>
{
    public override object? Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
    {
        using var doc = JsonDocument.ParseValue(ref reader);
        var element = doc.RootElement;
        return element.ValueKind switch
        {
            JsonValueKind.String => element.GetString(),
            JsonValueKind.Number => element.TryGetInt64(out var longNum) ? longNum : element.GetDouble(),
            JsonValueKind.True => true,
            JsonValueKind.False => false,
            JsonValueKind.Null => null,
            JsonValueKind.Guid => element.GetGuid(),
            _ => throw new NotSupportedException($"暂不支持的过滤值类型:{element.ValueKind}")
        };
    }

    public override void Write(Utf8JsonWriter writer, object value, JsonSerializerOptions options)
    {
        JsonSerializer.Serialize(writer, value, value.GetType(), options);
    }
}
  1. 在项目的服务配置(Program.cs 或 Startup.cs)中注册该转换器:
builder.Services.AddControllers()
    .AddJsonOptions(options =>
    {
        options.JsonSerializerOptions.Converters.Add(new ObjectPrimitiveConverter());
    });

配置完成后,接口接收到的 QueryFilterItem.Value 就会直接是字符串、Guid、数字、布尔值等原生类型,Dapper 可直接识别。

方案2:动态构造参数时手动转换(仅修改现有逻辑,无全局影响)

如果不想改动全局 Json 配置,可以在往 ExpandoObject 里加参数的位置,先判断值是否为 JsonElement,手动提取实际内容:

// 原有逻辑
// arguments.TryAdd($"{filter.Name}Entity{filter.FieldName}", filter.Value);

// 修改后
object paramValue = filter.Value;
// 处理 JsonElement 类型的值
if (paramValue is JsonElement jsonVal)
{
    paramValue = jsonVal.ValueKind switch
    {
        JsonValueKind.String => jsonVal.GetString(),
        JsonValueKind.Number => jsonVal.TryGetInt64(out var longNum) ? longNum : jsonVal.GetDouble(),
        JsonValueKind.True => true,
        JsonValueKind.False => false,
        JsonValueKind.Null => null,
        JsonValueKind.Guid => jsonVal.GetGuid(),
        _ => throw new NotSupportedException($"暂不支持的过滤值类型:{jsonVal.ValueKind}")
    };
}
arguments.TryAdd($"{filter.Name}Entity{filter.FieldName}", paramValue);

方案3:给 Dapper 注册自定义 JsonElement 类型处理器

如果一定要保留 JsonElement 类型不做提前转换,可以给 Dapper 增加类型映射规则,让它识别 JsonElement 作为参数:

  1. 新增类型处理器:
using System.Data;
using Dapper;
using System.Text.Json;

public class JsonElementDbTypeHandler : SqlMapper.TypeHandler<JsonElement>
{
    public override void SetValue(IDbDataParameter parameter, JsonElement value)
    {
        parameter.Value = value.ValueKind switch
        {
            JsonValueKind.String => value.GetString(),
            JsonValueKind.Number => value.TryGetInt64(out var longNum) ? longNum : value.GetDouble(),
            JsonValueKind.True => true,
            JsonValueKind.False => false,
            JsonValueKind.Null => DBNull.Value,
            JsonValueKind.Guid => value.GetGuid(),
            _ => throw new NotSupportedException($"暂不支持的 JsonElement 类型:{value.ValueKind}")
        };
    }

    public override JsonElement Parse(object value)
    {
        // 如果不需要从数据库读取值转成 JsonElement,可直接抛出 NotImplementedException
        throw new NotImplementedException();
    }
}
  1. 在程序启动时全局注册该处理器:
// 程序初始化时执行一次即可
SqlMapper.AddTypeHandler(new JsonElementDbTypeHandler());

内容的提问来源于stack exchange,提问作者bodynar

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.11 18:54:00