Jackson Databind 2.18.0 修复记录字段自定义序列化过滤失效问题

在 Java 序列化库 Jackson Databind 的使用过程中，开发者发现了一个关于记录类型（Record）字段序列化过滤的特殊问题。本文将深入分析该问题的成因、影响范围以及解决方案。

问题背景

当开发者尝试在 Java 记录类型（Record）的字段上使用 @JsonInclude 注解并指定自定义过滤器（valueFilter）时，发现该过滤器完全未被调用。具体表现为：

1. 过滤器类实例甚至未被创建
2. 注解配置看似被忽略
3. 相同配置在普通类（Class）上工作正常

问题复现

通过以下代码可以复现该问题：

public record MyRecord(
    @JsonInclude(value = JsonInclude.Include.CUSTOM, valueFilter = MyFilter.class)
    String field1,
    String field2
) {
    // 重写访问方法会导致过滤器失效
    @Override
    public String field1() {
        return field1;
    }
}

关键发现是：当记录类型的访问器方法被重写时，字段上的 @JsonInclude 注解会被忽略。

技术分析

该问题的根本原因在于 Jackson 对记录类型的特殊处理机制：

1. 在 2.18.0 之前的版本中，Jackson 对记录类型的注解处理存在缺陷
2. 当访问器方法被重写时，注解元数据未能正确传递
3. 序列化流程中跳过了自定义过滤器的检查环节

解决方案

官方修复

该问题已在 Jackson Databind 2.18.0 版本中修复。升级到该版本后，以下场景均可正常工作：

1. 记录类型字段上的 @JsonInclude 注解
2. 重写了访问器方法的记录类型
3. 自定义过滤器类的实例化和调用

临时解决方案

对于无法立即升级的用户，可采用以下替代方案：

public record MyRecord(String field1, String field2) {
    @JsonInclude(value = JsonInclude.Include.CUSTOM, valueFilter = MyFilter.class)
    @Override
    public String field1() {
        return field1;
    }
}

将注解移至重写的访问器方法上，可以绕过该问题。

最佳实践建议

1. 对于生产环境，建议升级到 Jackson Databind 2.18.0 或更高版本
2. 在记录类型中使用注解时，注意访问器方法重写的影响
3. 考虑在团队内部建立注解使用规范，避免混合使用字段和方法注解

总结

Jackson Databind 2.18.0 修复了记录类型字段自定义序列化过滤失效的问题，提升了框架在处理现代 Java 特性时的稳定性。开发者应当关注此类框架更新，及时获取功能改进和错误修复。