FasterXML Jackson 项目中的 BigDecimal 反序列化问题解析

问题背景

在 Jackson 数据绑定库的最新版本 2.17 中，开发团队发现了一个关于 BigDecimal 类型反序列化的行为变更问题。当尝试从 JSON 字符串中反序列化形如 "3." 这样的数值时，系统会抛出 InvalidFormatException 异常，提示这不是一个有效的数值表示。

技术细节分析

这个问题涉及到 JSON 数值格式的严格解析。根据 JSON 规范，一个有效的数值表示应当满足特定的格式要求。在 Jackson 2.17 版本之前，库对数值格式的验证相对宽松，能够接受一些非严格符合 JSON 规范的数值表示，如 "3." 和 ".5"。

从技术实现角度来看，这个问题主要存在于 jackson-core 模块中的 NumberInput 类，特别是 looksLikeValidNumber 方法。这个方法负责在数值解析前进行格式验证，其正则表达式模式限制了可接受的数值格式。

规范符合性考量

经过深入分析，开发团队确认：

1. "3." 这种以小数点结尾的数值表示确实不符合 JSON 规范
2. 但类似 ".5" 这样以小数点开头的数值表示同样不符合规范
3. 然而，考虑到 Jackson 需要支持多种数据格式（如 YAML 和 XML），这些格式可能有不同的数值表示规则

解决方案

开发团队最终决定采取以下措施：

1. 在 Jackson 2.17.2 和 2.18.0 版本中恢复对 "3." 格式的支持
2. 保持对 ".5" 格式的支持
3. 未来在 3.0 版本中可能会重新评估这些宽松规则

这个决策基于以下考虑：

• 向后兼容性：避免破坏现有系统的功能
• 多格式支持：Jackson 需要处理多种数据格式而不仅仅是 JSON
• 实用性：许多编程语言（如 Java 和 JavaScript）实际上都能解析这些非标准数值

开发者建议

对于需要使用严格 JSON 规范的开发者，建议：

1. 确保输入数据符合 JSON 数值规范
2. 考虑实现自定义的 BigDecimal 反序列化器来处理特殊格式
3. 在系统边界处进行数据验证，确保输入数据的规范性

总结

这个问题展示了开源库在规范严格性和实际应用灵活性之间的权衡。Jackson 作为一个广泛使用的数据绑定库，需要在遵循标准的同时兼顾实际开发中的各种使用场景。开发团队通过仔细分析后做出的决策，既维护了系统的稳定性，又为开发者提供了足够的灵活性。