MyBatis-Plus 中 Fastjson 反序列化字段解析问题解析

问题背景

在使用 MyBatis-Plus 2.0.53 版本时，开发者遇到了一个 JSON 反序列化的特殊问题：在程序运行时无法正确解析 JSON 字符串中的字段，但在单元测试中却可以正常解析。这个问题涉及到 Fastjson 库的行为特性，值得深入分析。

现象描述

开发者提供的代码示例展示了一个典型的 JSON 反序列化场景：

1. 有一个包含 signedMsg 字段的 JSON 字符串
2. 对应的 Java 类 ResponseFooter 中有同名的 signedMsg 属性
3. 程序运行时无法正确解析该字段
4. 单元测试中可以正常解析
5. 通过添加 @JSONField 注解或开启 SupportSmartMatch 特性可以解决问题

根本原因分析

这个问题实际上与 MyBatis-Plus 本身关系不大，主要是 Fastjson 的反序列化行为导致的。Fastjson 2.x 版本在字段匹配上比 1.x 版本更加严格，这可能导致以下情况：

1. 字段名大小写敏感：Fastjson 2.x 默认对字段名大小写敏感，如果 JSON 中的字段名与 Java 属性名在大小写上不完全一致，可能导致无法匹配。

2. Getter/Setter 方法影响：Fastjson 在反序列化时会考虑 JavaBean 规范，如果属性的 getter/setter 方法命名不规范，可能影响字段匹配。

3. 运行环境差异：单元测试环境与真实运行环境可能存在类加载器、依赖版本等方面的差异，导致行为不一致。

解决方案

针对这个问题，开发者可以采用以下几种解决方案：

1. 使用 @JSONField 注解明确指定映射关系

@Data
public class ResponseFooter implements Serializable {
    @JSONField(name = "signedMsg")
    private String signedMsg = "";
    // 其他字段...
}

这是最直接和可靠的解决方案，明确指定 JSON 字段与 Java 属性的映射关系。

2. 开启 SupportSmartMatch 特性

JSONReader.Feature.SupportSmartMatch.enabled = true;

这个特性会启用更宽松的字段匹配策略，包括忽略大小写等。

3. 检查并统一命名规范

确保 JSON 字段名与 Java 属性名在命名风格上保持一致：

• 都使用驼峰命名法
• 或者都使用下划线分隔

4. 检查运行环境依赖

确认运行环境和测试环境使用的 Fastjson 版本一致，避免因版本差异导致的行为不一致。

最佳实践建议

1. 显式优于隐式：对于重要的字段映射，建议总是使用 @JSONField 注解明确指定，而不是依赖自动匹配。

2. 环境一致性：确保开发、测试和生产环境的依赖版本一致，可以使用依赖管理工具如 Maven 或 Gradle 的 dependencyManagement 来统一版本。

3. 日志调试：在遇到反序列化问题时，可以增加日志输出，查看 Fastjson 实际解析过程中的细节。

4. 考虑使用构造函数：对于不可变对象，可以考虑使用带有 @JSONCreator 注解的构造函数来进行反序列化，这种方式更加明确可靠。

总结

这个案例展示了 JSON 反序列化过程中可能遇到的微妙问题，特别是在不同环境下表现不一致的情况。通过理解 Fastjson 的工作机制和采用明确的映射策略，可以有效地避免这类问题。作为开发者，在处理数据绑定和序列化/反序列化时，应该倾向于使用显式的配置方式，这样可以提高代码的可维护性和可靠性。