Java Spring如何处理JSON可选/额外参数及响应冗余字段

一、接收请求时的可选参数、冗余/废弃字段处理 #

Spring Boot默认使用Jackson完成JSON和Java对象的转换，处理这类兼容问题不需要额外引入组件，按以下规则配置即可：

• 全局统一配置兜底：直接在项目配置文件中开启Jackson反序列化的未知字段忽略规则，配置后所有@RequestBody标注的参数，遇到JSON里有但Java DTO类没定义的字段时，会直接跳过不解析，不会抛出HttpMessageNotReadableException异常。

spring:
  jackson:
    deserialization:
      fail-on-unknown-properties: false

• 单类特殊规则适配：如果不想全局开启该配置，只需要给特定的DTO类加上注解@JsonIgnoreProperties(ignoreUnknown = true)，就能实现单类的未知字段忽略，适配个别接口的兼容需求。
• 废弃字段平滑过渡：业务上不再使用的旧字段不要第一时间从DTO中删除，先保留至少2-3个迭代版本，给字段加@Deprecated注解标注废弃状态，注释里说明废弃版本、替代方案，等确认所有调用方都完成升级后再删除字段，比单纯靠未知字段忽略兜底更稳妥。
• 可选参数处理：不需要强制传的字段不要加@NotNull这类必填校验注解，字段类型用包装类（不要用int/long这类基本类型，避免不传时抛空指针），业务逻辑里按需判空处理即可，也可以给字段设置默认值适配不传的场景。

注意：如果DTO使用了Lombok的@Builder注解，记得加上@NoArgsConstructor和@AllArgsConstructor注解，避免Jackson反序列化时因为找不到合适的构造器抛错。

二、WebClient调用时处理响应中的未知冗余字段 #

WebClient默认复用Spring上下文里全局配置的ObjectMapper做响应反序列化，所以上面提到的全局fail-on-unknown-properties=false配置，默认就会对WebClient的响应解码生效，响应里多出来的、你在响应DTO里没定义的字段会被直接跳过，不会触发解码异常。
如果需要更细粒度的控制，可以按场景选择方案：

• 个别响应类特殊处理：直接给对应的响应DTO类加上@JsonIgnoreProperties(ignoreUnknown = true)注解，不需要修改全局配置，就能实现单个响应类型的未知字段忽略。
• 只需要少量字段的场景：如果不需要完整解析整个响应，只需要取其中几个固定字段，可以直接把响应解析为JsonNode类型，按需提取需要的字段即可，完全不受其他冗余字段影响，示例代码：

webClient.post()
    .uri("/rpc/queryUserInfo")
    .bodyValue(req)
    .retrieve()
    .bodyToMono(JsonNode.class)
    .map(respNode -> {
        // 只取需要的uid、username字段，其他冗余字段全部忽略
        Long uid = respNode.get("uid").asLong();
        String username = respNode.get("username").asText();
        return new UserSimpleInfo(uid, username);
    })
    .block();

微服务交互不建议做严格的全字段匹配，跨团队维护的服务经常会在迭代中新增返回字段（比如调试标记、链路追踪字段、冗余的提示信息），开启未知字段忽略后，只要你依赖的字段名称、类型没有变更，就不会因为对方的非破坏性更新导致调用故障。

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