Jackson-databind中NON_DEFAULT注解对空字符串处理的变更分析

问题背景

在Jackson-databind 2.18.0版本中，当使用@JsonInclude(JsonInclude.Include.NON_DEFAULT)注解时，如果POJO属性的默认值为null，那么空字符串("")将不再被包含在JSON输出中。这一行为变更引发了开发者社区的讨论，因为它影响了某些依赖此行为的应用程序。

技术细节解析

NON_DEFAULT注解的设计初衷

@JsonInclude(JsonInclude.Include.NON_DEFAULT)注解的核心设计理念是：只有当属性值与POJO的默认值不同时，才将该属性包含在JSON输出中。这里的"默认值"指的是通过无参构造函数创建的POJO实例中属性的初始值。

变更前后的行为对比

在2.17.1及之前版本中：

• 如果默认值为null，设置空字符串("")会被视为与默认值不同，因此会被包含在JSON输出中
• 这符合JavaDoc中关于null处理的特殊说明

在2.18.0版本中：

• 空字符串("")不再被视为与null不同，因此不会被包含在JSON输出中
• 这一变更源于对另一个问题(#4464)的修复

技术原理分析

问题的核心在于如何判断属性值是否等于默认值。Jackson对此有两种处理方式：

1. 对于非null值：使用equals()方法进行比较
2. 对于null值：直接进行null检查

在2.18.0的变更中，空字符串("")被错误地归类为与null等效，这违背了JavaDoc中明确说明的特殊处理规则。

解决方案与修复

Jackson开发团队确认这是一个有效的bug报告，并在2.18.1版本中进行了修复。修复后的行为将：

1. 严格区分null和空字符串("")
2. 当默认值为null时，空字符串会被视为不同的值而包含在JSON输出中
3. 保持对全局设置和POJO注解的不同上下文处理

开发者建议

对于依赖此行为的开发者，建议：

1. 如果需要保留空字符串，可以升级到2.18.1或更高版本
2. 如果暂时无法升级，可以考虑使用@JsonInclude(JsonInclude.Include.ALWAYS)作为临时解决方案
3. 在设计POJO时，明确考虑null和空字符串("")的语义差异

总结

这个案例展示了序列化框架中默认值处理的复杂性，特别是当涉及null和空值的边界情况时。Jackson团队通过快速响应和修复，确保了框架行为与文档描述的一致性，同时也提醒开发者在升级版本时需要注意此类细微但重要的行为变更。