Kotlin无符号类型（UShort/UInt）Jackson反序列化问题排查

问题根源 #

你混淆了kotlinx.serialization和Jackson两套独立的序列化体系：kotlin序列化插件仅针对kotlinx.serialization生效，无法直接为Jackson提供无符号类型的反序列化支持。Jackson需要专门的模块配置才能处理Kotlin无符号类型，同时必须确保正确注册Kotlin模块以识别数据类的构造函数。

具体解决步骤 #

1. 确保依赖正确 #

在build.gradle.kts中引入Jackson的Kotlin模块（使用最新稳定版本）：

dependencies {
    // Jackson Kotlin模块，提供Kotlin类型支持
    implementation("com.fasterxml.jackson.module:jackson-module-kotlin:2.16.1")
    // 其他依赖（如Jackson核心）...
}

2. 配置ObjectMapper以支持无符号类型 #

创建ObjectMapper时，显式注册Kotlin模块并启用无符号类型支持：

import com.fasterxml.jackson.module.kotlin.KotlinModule
import com.fasterxml.jackson.module.kotlin.KotlinFeature
import com.fasterxml.jackson.databind.ObjectMapper

val objectMapper = ObjectMapper().apply {
    registerModule(
        KotlinModule.Builder()
            .enable(KotlinFeature.SupportUByte)
            .enable(KotlinFeature.SupportUShort)
            .enable(KotlinFeature.SupportUInt)
            .enable(KotlinFeature.SupportULong)
            .build()
    )
}

注：Jackson 2.13及以上版本中，Kotlin模块默认已包含无符号类型支持，但显式启用能避免版本兼容问题。

3. 统一注解体系（可选） #

如果你的数据类用了kotlinx.serialization的注解（如@SerialName），Jackson无法识别，需替换为Jackson的注解（如@JsonProperty）：

import com.fasterxml.jackson.annotation.JsonProperty

data class Request(
    @JsonProperty("id") val id: UInt,
    @JsonProperty("code") val code: UShort
)

若不需要跨序列化框架，也可省略注解，Jackson会默认匹配字段名。

4. 使用配置好的ObjectMapper反序列化 #

在测试代码中，用上述配置的objectMapper替代默认实例：

fun main() {
    val json = """{"id": 12345, "code": 67}"""
    val request = objectMapper.readValue(json, Request::class.java)
    println(request)
}

报错原因解析 #

你遇到的InvalidDefinitionException本质是Jackson未注册Kotlin模块，既无法识别Kotlin数据类的构造函数，也缺乏无符号类型的反序列化逻辑。注册Kotlin模块后，Jackson才能正确解析数据类的构造参数，并处理UShort、UInt等类型。

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