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 类型:
- 新增转换器类:
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); } }
- 在项目的服务配置(
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 作为参数:
- 新增类型处理器:
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(); } }
- 在程序启动时全局注册该处理器:
// 程序初始化时执行一次即可 SqlMapper.AddTypeHandler(new JsonElementDbTypeHandler());
内容的提问来源于stack exchange,提问作者bodynar
相关产品推荐
相关产品推荐

