Jackson无法反序列化DTO的ULong属性 自定义序列化器写入报错
Jackson处理Kotlin ULong类型的适配方案
核心问题根源
Jackson原生的数值写入接口只支持Java定义的基础数值类型(int、long、BigInteger等),而Kotlin的ULong是独立的无符号值类型,取值范围超出Java long的最大上限,直接传入ULong给writeNumber方法会触发类型不兼容的编译错误;同时当前编写的自定义序列化器本身存在多处逻辑问题,会进一步导致序列化、反序列化流程完全失效。
可落地的修复步骤
修正现有序列化器的逻辑错误
- 移除多余的嵌套对象逻辑: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()) } }- 移除多余的嵌套对象逻辑:ULong作为单值字段不需要包裹
配套实现反序列化器
仅实现序列化器无法解决请求体解析的问题,需要同步编写对应类型的反序列化器,处理Postman传入的请求内容:class ULongDeserializer : StdDeserializer<ULong>(ULong::class.java) { override fun deserialize(p: JsonParser, ctxt: DeserializationContext): ULong { return p.valueAsString.toULong() } }注册自定义模块
将序列化器、反序列化器成对注册到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
相关产品推荐
相关产品推荐

