Android中使用Jackson MixIn解析多态JSON触发NPE的解决方法

这个NPE问题在Jackson处理Kotlin密封类的多态反序列化时很常见，我来帮你一步步排查和解决：

核心原因分析 #

你遇到的NullPointerException本质上是Jackson在尝试解析Mixin和密封类的字段映射时，找不到正确的注解元数据，导致访问了null的Map对象。通常和Mixin未正确注册、缺少Kotlin支持模块这两个因素有关。

具体解决方案 #

1. 确保Mixin正确注册并添加Kotlin模块 #

Jackson处理Kotlin类必须依赖KotlinModule，而且你需要显式把Mixin绑定到目标密封类。修改你的ObjectMapper初始化代码：

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

val jsonMapper = ObjectMapper()
    .registerModule(KotlinModule()) // 必须添加，否则Jackson无法正确处理Kotlin类
    .addMixIn(NotificationEvent::class.java, NotificationEventMixIn::class.java) // 绑定Mixin到密封类

如果是Spring Boot环境，可以通过配置类来完成：

@Configuration
class JacksonConfig {
    @Bean
    fun objectMapper(): ObjectMapper {
        return ObjectMapper()
            .registerModule(KotlinModule())
            .addMixIn(NotificationEvent::class.java, NotificationEventMixIn::class.java)
    }
}

2. 简化方案：直接在密封类上添加注解（推荐） #

其实没必要单独写Mixin类，直接把多态注解加到密封类本身上，代码更简洁，也能避免Mixin关联的问题：

import com.fasterxml.jackson.annotation.JsonSubTypes
import com.fasterxml.jackson.annotation.JsonTypeInfo

@JsonTypeInfo(
    use = JsonTypeInfo.Id.NAME,
    include = JsonTypeInfo.As.PROPERTY,
    property = "eventType"
)
@JsonSubTypes(
    JsonSubTypes.Type(
        value = NotificationEvent.SomeUsefulEvent::class,
        name = "FirstType"
    )
)
sealed class NotificationEvent {
    data class SomeUsefulEvent(val eventData: String): NotificationEvent()
}

这样初始化ObjectMapper时只需要注册Kotlin模块即可，无需额外绑定Mixin：

val jsonMapper = ObjectMapper().registerModule(KotlinModule())

3. 验证修复效果 #

用你的测试JSON验证反序列化：

val testJson = """{"eventType": "FirstType", "eventData": "some-useful-object"}"""
val event = jsonMapper.readValue<NotificationEvent>(testJson)
println(event) // 输出：SomeUsefulEvent(eventData=some-useful-object)

为什么原来的代码会崩溃？ #

你之前的代码大概率是没有注册KotlinModule，或者没有把Mixin绑定到ObjectMapper。Jackson在处理Kotlin密封类时，缺少Kotlin模块会导致反射解析字段失败；而Mixin未绑定的话，Jackson无法识别eventType字段的多态映射规则，最终在内部处理时访问了null的Map对象，抛出NPE。

内容的提问来源于stack exchange，提问作者Денис Клещев