通过使用 optional 或 jsonnullable 包装可选字段，可在共享同一 pojo 的前提下，灵活控制 json 序列化时是否包含该字段，从而满足不同 rest 端点对请求结构的差异化要求。
通过使用 optional 或 jsonnullable 包装可选字段，可在共享同一 pojo 的前提下，灵活控制 json 序列化时是否包含该字段，从而满足不同 rest 端点对请求结构的差异化要求。
在微服务或前后端协作开发中，常需复用同一数据模型（如 UserRequest）向多个 REST 接口发送请求，但各接口对字段的要求并不一致：有的仅接受子集字段，若多传了字段（哪怕是 null），可能直接导致 400 Bad Request 或服务端校验失败。此时，简单使用 @JsonIgnore 并不可行——它会全局忽略字段，无法按场景动态控制；而为每个端点单独定义 DTO 又违背 DRY 原则、增加维护成本。
推荐方案：用 Optional 实现条件序列化
Jackson 默认不序列化值为 null 的字段（需确保配置 SerializationFeature.WRITE_NULLS 为 false，这是默认行为），但 Optional.empty() 不等于 null，因此需配合 Jackson 的 @JsonInclude(JsonInclude.Include.NON_EMPTY) 或更精准的 @JsonInclude(JsonInclude.Include.NON_ABSENT)：
import com.fasterxml.jackson.annotation.JsonInclude;
import java.util.Optional;
public class UserRequest {
private String field1;
private String field2;
private String field3;
@JsonInclude(JsonInclude.Include.NON_ABSENT)
private Optional<string> field4;
// 构造函数、getter/setter 略
public UserRequest(String field1, String field2, String field3) {
this.field1 = field1;
this.field2 = field2;
this.field3 = field3;
this.field4 = Optional.empty(); // Endpoint-1 不传 field4
}
public UserRequest(String field1, String field2, String field3, String field4) {
this.field1 = field1;
this.field2 = field2;
this.field3 = field3;
this.field4 = Optional.ofNullable(field4); // Endpoint-2 显式传入
}
}</string>
✅ 效果说明：
- 向 Endpoint-1 发送实例时，field4 = Optional.empty() → 序列化后 JSON 完全不包含 field4 字段；
- 向 Endpoint-2 发送时，field4 = Optional.of("value") → 序列化后 JSON 包含 "field4": "value"；
- 若传入 Optional.ofNullable(null)，仍等效于 Optional.empty()，安全可靠。
⚠️ 注意事项：
- 确保项目中 Jackson 版本 ≥ 2.9（NON_ABSENT 自 2.9 起支持）；
- Optional 仅适用于 只读场景（如请求体），不建议用于 JPA 实体或需要反序列化的响应模型（因 Optional 在反序列化时存在限制）；
- 若需双向支持（即也允许服务端返回 Optional 字段），可搭配 jackson-databind-nullable 库使用 JsonNullable
，其专为 JSON 场景设计，语义更清晰：
<!-- Maven --> <dependency><groupid>org.openapitools</groupid><artifactid>jackson-databind-nullable</artifactid><version>0.2.6</version></dependency>
private JsonNullable<string> field4; // 序列化逻辑同 Optional，但反序列化更健壮</string>
总结：Optional + @JsonInclude(NON_ABSENT) 是轻量、标准、零依赖的解决方案；若项目已引入 OpenAPI 工具链或需更强类型语义，JsonNullable 是更专业的替代选择。二者均能实现「一 POJO 多端点」的灵活适配，避免冗余类与运行时错误。
