如何在方法级控制ObjectMapper序列化时的Null值处理？

核心需求拆解 #

同一实体类需要支持两种序列化逻辑：忽略Null值字段和保留Null值字段，需避免为每个类单独配置，实现全局复用且低维护成本。

最优方案1：全局复用ObjectMapper实例（推荐） #

ObjectMapper是线程安全的，可创建两个全局单例实例，分别预设不同的Null值处理策略，所有类直接复用即可：

// 全局单例：序列化时忽略所有Null值字段
private static final ObjectMapper MAPPER_IGNORE_NULL = new ObjectMapper()
        .setSerializationInclusion(JsonInclude.Include.NON_NULL);

// 全局单例：序列化时保留所有Null值字段（默认行为，也可显式配置）
private static final ObjectMapper MAPPER_KEEP_NULL = new ObjectMapper()
        .setSerializationInclusion(JsonInclude.Include.ALWAYS);

使用时直接调用对应实例：

// 对接需要忽略Null的系统
String jsonWithoutNull = MAPPER_IGNORE_NULL.writeValueAsString(new User().setAge(11).setName("Christian"));
// 对接需要保留Null的系统
String jsonWithNull = MAPPER_KEEP_NULL.writeValueAsString(new User().setAge(11).setName("Christian"));

该方案无需修改任何实体类，代码简洁、性能高，完全适配大量类的场景，避免重复配置的繁琐和出错风险。

方案2：方法级临时配置（适合临时场景） #

若不想维护全局实例，可在单个方法内临时创建配置好的ObjectMapper实例（注意：直接修改全局实例配置会有线程安全问题，推荐用copy()创建临时实例）：

// 临时生成忽略Null的序列化实例
ObjectMapper tempIgnoreMapper = new ObjectMapper().setSerializationInclusion(JsonInclude.Include.NON_NULL);
String jsonWithoutNull = tempIgnoreMapper.writeValueAsString(user);

// 临时生成保留Null的序列化实例
ObjectMapper tempKeepMapper = new ObjectMapper().setSerializationInclusion(JsonInclude.Include.ALWAYS);
String jsonWithNull = tempKeepMapper.writeValueAsString(user);

方案3：JsonView+Mixin细粒度控制（复杂场景） #

如果需要针对特定字段做差异化处理（而非全局统一策略），可结合@JsonView和Mixin实现，无需修改原实体类：

1. 定义两个标记接口作为视图标识：

public interface IgnoreNullView {}
public interface KeepNullView {}

2. 用Mixin类统一配置实体类的字段策略：

// Mixin类，无需修改原User类
abstract class UserMixin {
    // 忽略Null的视图下，email字段为空时不序列化
    @JsonInclude(JsonInclude.Include.NON_NULL)
    @JsonView(IgnoreNullView.class)
    String email;

    // 保留Null的视图下，email字段为空时仍序列化
    @JsonInclude(JsonInclude.Include.ALWAYS)
    @JsonView(KeepNullView.class)
    String email;
}

3. 注册Mixin并指定视图序列化：

ObjectMapper mapper = new ObjectMapper();
mapper.addMixIn(User.class, UserMixin.class);

// 按忽略Null视图序列化
String jsonWithoutNull = mapper.writerWithView(IgnoreNullView.class).writeValueAsString(user);
// 按保留Null视图序列化
String jsonWithNull = mapper.writerWithView(KeepNullView.class).writeValueAsString(user);

内容的提问来源于stack exchange，提问作者Eric Chen