You need to enable JavaScript to run this app. Jackson无法反序列化DTO的ULong属性 自定义序列化器写入报错
优惠活动
大模型
产品
解决方案
定价
更多

Jackson无法反序列化DTO的ULong属性 自定义序列化器写入报错

Jackson处理Kotlin ULong类型的适配方案

核心问题根源

Jackson原生的数值写入接口只支持Java定义的基础数值类型(int、long、BigInteger等),而Kotlin的ULong是独立的无符号值类型,取值范围超出Java long的最大上限,直接传入ULong给writeNumber方法会触发类型不兼容的编译错误;同时当前编写的自定义序列化器本身存在多处逻辑问题,会进一步导致序列化、反序列化流程完全失效。

可落地的修复步骤

  1. 修正现有序列化器的逻辑错误

    • 移除多余的嵌套对象逻辑:ULong作为单值字段不需要包裹writeStartObject()/writeEndObject(),否则会将本应为数字的字段序列化为空对象结构,和DTO定义的字段类型不匹配。
    • 修正方法、参数的拼写错误:重写的方法名应为serialize,而非serializer;参数类型分别为JsonGenerator、SerializerProvider,避免因为拼写错误导致类无法编译生效。
    • 适配writeNumber的入参要求:由于ULong无法直接匹配Jackson原生方法的参数类型,可将ULong转为十进制字符串后传入writeNumber方法,既不会触发类型不兼容问题,也能避免数值超出Long范围时的精度丢失。

    修正后的序列化器参考实现:

    class ULongSerializer : StdSerializer<ULong>(ULong::class.java) {
        override fun serialize(value: ULong, gen: JsonGenerator, provider: SerializerProvider) {
            gen.writeNumber(value.toString())
        }
    }
    
  2. 配套实现反序列化器
    仅实现序列化器无法解决请求体解析的问题,需要同步编写对应类型的反序列化器,处理Postman传入的请求内容:

    class ULongDeserializer : StdDeserializer<ULong>(ULong::class.java) {
        override fun deserialize(p: JsonParser, ctxt: DeserializationContext): ULong {
            return p.valueAsString.toULong()
        }
    }
    
  3. 注册自定义模块
    将序列化器、反序列化器成对注册到Jackson的Kotlin扩展模块中,确保框架在遇到ULong类型时自动调用对应逻辑:

    val kotlinModule = KotlinModule.Builder().build()
    kotlinModule.addSerializer(ULong::class.java, ULongSerializer())
    kotlinModule.addDeserializer(ULong::class.java, ULongDeserializer())
    objectMapper.registerModule(kotlinModule)
    

更简便的替代方案

如果不想手写自定义序列化/反序列化逻辑,可直接升级jackson-module-kotlin依赖到2.10以上版本,该版本已经内置了对ULong类型的原生支持,不需要额外编写适配代码即可完成序列化、反序列化流程。

注意:ULong的取值范围为0到2^64-1,超出Java long的可表示范围,实现适配时不要尝试将ULong强转为Java Long类型传递,否则会出现数值溢出、精度丢失的问题。


内容的提问来源于stack exchange,提问作者Vinicius de Andrade

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.28 21:27:03