Jackson-databind中List字段重复序列化问题的分析与解决方案

问题现象

在使用Jackson-databind进行对象序列化/反序列化时，当Java类中存在多个getter方法返回同一个List字段时，经过多次序列化/反序列化操作后，List中的元素会出现指数级增长。例如初始包含1个元素的List，经过16次处理后可能膨胀到65,536个重复元素。

技术背景

Jackson默认启用了USE_GETTERS_AS_SETTERS特性（MapperFeature），这是为了兼容JAXB的行为模式而设计的。该特性的核心机制是：

1. 对于Collection/Map类型的字段，Jackson会使用getter方法获取对象引用
2. 反序列化时不是替换整个集合，而是向现有集合中添加元素
3. 当存在多个getter指向同一字段时，每个getter都会被处理，导致元素重复添加

典型场景

以下情况容易触发此问题：

1. 类继承结构中，父类定义通用getter方法，子类使用Lombok生成字段getter
2. 同一个字段有多个不同名称的getter方法
3. 使用字段注入的框架与显式getter共存

解决方案

推荐方案

@JsonIgnore // 在不需要序列化的getter上添加此注解
public List<String> getMyIds() {
    return ids;
}

替代方案

1. 禁用问题特性（需Jackson 2.x）

mapper.disable(MapperFeature.USE_GETTERS_AS_SETTERS);

2. 显式指定字段序列化

@JsonProperty // 强制使用字段而非getter
private List<String> ids;

3. 升级到Jackson 3.0（该版本已默认禁用此特性）

最佳实践建议

1. 避免为同一字段创建多个getter
2. 使用Lombok时注意检查生成的getter是否与继承的方法冲突
3. 在缓存序列化场景中特别关注集合类型字段
4. 考虑使用不可变集合防止意外修改

原理深度解析

Jackson处理POJO时的属性发现机制遵循以下优先级：

1. 显式注解（如@JsonProperty）
2. 可见的字段（取决于可见性规则）
3. getter/setter方法

当多个getter指向同一字段时，Jackson会：

1. 序列化：生成多个JSON属性
2. 反序列化：通过每个getter获取集合引用并追加元素

这种设计虽然提高了灵活性，但也带来了潜在的内存风险，特别是在高频序列化的缓存场景中。

总结

这个问题揭示了框架设计中的权衡取舍：便利性 vs 安全性。Jackson团队已在3.0版本中调整了默认行为，但对于2.x用户，理解这个机制并合理使用@JsonIgnore注解是避免生产事故的关键。在涉及集合操作的序列化场景中，开发者应当特别注意属性访问的明确性和一致性。