目录
一、核心定位
二、原生 Jackson 处理 Kotlin 的原生痛点（不加该依赖会出现的问题）
1. Kotlin 数据类 data class 反序列化失败
2. 属性默认值丢失
3. 只读属性 val 无法赋值
4. 可空类型 / 非空类型校验失效
5. 特殊类型无法序列化
6. 不识别 Kotlin 注解
三、jackson-module-kotlin 核心功能（逐一解决上面问题）
1. 自动适配全参构造，无需无参构造
2. 自动填充构造参数默认值
3. 支持 val 只读属性注入
4. 强 Kotlin 空安全校验
5. 全面兼容 Kotlin 特有类型
6. 优化枚举序列化
7. 兼容 Kotlin 注解与 Jackson 注解联动
8. 支持内联类 value class（新版模块）
四、如何启用模块（必须注册才生效，只加依赖没用）
SpringBoot 项目（自动注册，无需手动配置）
原生 Kotlin/Java 项目手动注册
五、实战对比：有无依赖的差异示例
定义 Kotlin 数据类
六、版本匹配注意事项
七、总结一句话作用
一、核心定位
jackson-module-kotlin是 Jackson 官方提供的Kotlin 专用扩展模块，专门解决 Jackson 原生（Java 版）序列化 / 反序列化 Kotlin 代码时的各类兼容缺陷，让 Jackson 完美支持 Kotlin 独有语法：数据类、无参构造、默认参数、空安全、顶层函数、val/var、nullable类型等。
Jackson 原生只适配 Java 语法，直接序列化 Kotlin 类会大量报错，这个模块就是兼容桥。
二、原生 Jackson 处理 Kotlin 的原生痛点（不加该依赖会出现的问题）
1. Kotlin 数据类data class反序列化失败
Kotlin 数据类只有全参构造函数，没有无参构造； 原生 Jackson 默认需要无参构造实例化对象，直接抛异常：No suitable constructor found for type ... can not instantiate from JSON object
2. 属性默认值丢失
Kotlin 支持构造参数默认值：
data class User(val name: String, val age: Int = 18)原生 Jackson 反序列化时，如果 JSON 不传age，不会自动填充默认值，直接赋值null，触发空安全崩溃。
3. 只读属性val无法赋值
Kotlinval是只读字段，无 setter；Java 反射无法修改，原生 Jackson 无法给val属性注入 JSON 值。
4. 可空类型 / 非空类型校验失效
val phone: String?/val id: Long原生 Jackson 不会校验空安全，JSON 传null给非空字段不会报错，运行时空指针。
5. 特殊类型无法序列化
- Kotlin 集合：
List<T>、MutableList、Sequence - 单例
object、枚举enum class、密封类sealed class Pair/Triple、Unit、顶层变量- 延迟初始化
lateinit、委托属性by lazy
6. 不识别 Kotlin 注解
@JvmField、@JsonIgnore在 Kotlin 中行为异常，原生 Jackson 解析逻辑错乱。
三、jackson-module-kotlin 核心功能（逐一解决上面问题）
1. 自动适配全参构造，无需无参构造
模块内部集成 Kotlin 反射，读取类的主构造函数，通过带参构造直接实例化对象，不再强制要求空构造，data class开箱即用。
2. 自动填充构造参数默认值
反序列化时：
- 读取 Kotlin 元数据，获取每个参数默认值；
- JSON 缺失字段时，自动使用代码里定义的默认值；
- 避免手动给字段赋默认、空指针。
3. 支持val只读属性注入
通过 Kotlin 反射绕过 Java setter 限制，直接通过构造函数赋值，val属性完全正常序列化、反序列化。
4. 强 Kotlin 空安全校验
反序列化时校验类型可空性：
- 非空字段（
String）JSON 传null→ 直接抛出序列化异常，提前拦截 NPE； - 可空字段（
String?）允许null，符合 Kotlin 语法规范。
5. 全面兼容 Kotlin 特有类型
- 数据类 data class
- 单例 object、密封类 sealed class、枚举
- Pair/Triple、Range、Sequence
- 顶层类、顶层函数返回值
- Mutable 可变集合、不可变集合
6. 优化枚举序列化
Kotlin 枚举支持属性、自定义构造，模块适配枚举的序列化 / 枚举名称匹配。
7. 兼容 Kotlin 注解与 Jackson 注解联动
让@JsonProperty、@JsonIgnore、@JsonFormat在 Kotlin 类中行为和 Java 完全一致，识别@JvmField修饰字段。
8. 支持内联类value class（新版模块）
高版本 jackson-module-kotlin 支持 Kotlin 1.5+ 内联值类序列化。
四、如何启用模块（必须注册才生效，只加依赖没用）
SpringBoot 项目（自动注册，无需手动配置）
SpringBoot 自动检测 classpath 存在jackson-module-kotlin，会自动把模块注册到全局ObjectMapper，直接使用。
原生 Kotlin/Java 项目手动注册
import com.fasterxml.jackson.databind.ObjectMapper import com.fasterxml.jackson.module.kotlin.registerKotlinModule val mapper = ObjectMapper() .registerKotlinModule() // 核心注册代码五、实战对比：有无依赖的差异示例
定义 Kotlin 数据类
data class User( val username: String, val age: Int = 18, val email: String? )JSON 输入（缺少 age）：
{"username":"zhangsan","email":null}不加 jackson-module-kotlin
- 反序列化直接报错：找不到构造函数；
- 就算加无参构造，age 不会填充 18，变成 null，访问 age 触发空指针。
添加并注册模块后
- 通过全参构造创建 User；
- age 自动赋值默认值 18；
- email 允许 null（声明为可空）；
- 如果 email 定义为
String（非空），JSON 传 null 直接抛序列化异常。
六、版本匹配注意事项
该模块版本必须和核心 jackson-databind 版本保持一致，否则反射兼容报错：
<!-- jackson 核心包 --> <dependency> <groupId>com.fasterxml.jackson.core</groupId> <artifactId>jackson-databind</artifactId> <version>2.15.2</version> </dependency> <!-- kotlin 模块版本和上面完全一致 --> <dependency> <groupId>com.fasterxml.jackson.module</groupId> <artifactId>jackson-module-kotlin</artifactId> <version>2.15.2</version> </dependency>七、总结一句话作用
jackson-module-kotlin是 Jackson 的 Kotlin 反射兼容模块，补齐原生 Jackson 对 Kotlin 数据类、默认参数、val 只读属性、空安全、特殊类型的序列化 / 反序列化支持，解决无构造报错、默认值丢失、空指针等一系列 Kotlin 序列化问题，是 SpringBoot Kotlin 项目必引依赖。
