随着Spring Boot 4的正式发布，开发者们迎来了与Jackson 3的深度整合。这一组合带来了更高效的序列化/反序列化能力，但也引发了一个常见问题：当请求体中的某些字段缺失时，如何优雅地设置默认值？本文将深入探讨这一技术细节，并提供多种解决方案。

背景：为何需要请求体默认值？

在现代微服务架构中，API接口常需要处理部分缺失的请求数据。例如，用户注册接口中“昵称”字段可选，若客户端未传递，系统应自动赋予默认值如“匿名用户”，而非抛出异常或返回空值。Spring Boot 4与Jackson 3的默认行为会直接将缺失字段设为null，这往往导致后续逻辑需要额外判空处理。因此，开发者亟需一种声明式的方式来指定默认值。

Jackson 3的新特性：@JsonProperty的默认值支持

Jackson 3相比2.x版本，对@JsonProperty注解做了增强。现在你可以直接在其defaultValue属性中指定一个字符串，当字段缺失时，Jackson会尝试将该字符串转换为字段类型并赋值。

public class UserRequest {
    @JsonProperty(defaultValue = "匿名用户")
    private String nickname;

    private int age;
    // getters and setters
}

但需注意：defaultValue仅在使用@JsonSetter(nulls = Nulls.SKIP)或全局配置启用时才生效。在Spring Boot 4中，默认的ObjectMapper配置并未开启此功能，需要手动设置。

方案一：全局配置Jackson ObjectMapper

最彻底的方式是在Spring Boot应用中自定义Jackson配置，启用对@JsonProperty.defaultValue的支持。

@Configuration
public class JacksonConfig {
    @Bean
    public Jackson2ObjectMapperBuilderCustomizer customizer() {
        return builder -> builder
            .postConfigurer(mapper -> {
                mapper.configOverride(Object.class)
                    .setSetterInfo(JsonSetter.Value.forValueNulls(Nulls.SKIP));
            });
    }
}

此配置告诉Jackson：当遇到空值时（包括缺失字段），不要注入null，而是检查@JsonProperty.defaultValue。配合上面的UserRequest，若请求体缺少nickname，Jackson会自动将其赋值为“匿名用户”。

方案二：使用@JsonSetter的nulls属性

Jackson 3允许对单个字段进行精细控制。你可以直接在字段getter或setter上使用@JsonSetter(nulls = Nulls.SKIP)，但更推荐结合@JsonProperty(defaultValue)使用：

public class UserRequest {
    @JsonProperty(defaultValue = "匿名用户")
    @JsonSetter(nulls = Nulls.SKIP)
    private String nickname;
}

这种方式粒度更细，但需要在每个需要默认值的字段上重复注解。适合少数特殊字段。

方案三：自定义反序列化器

对于复杂类型（如嵌套对象、集合），默认的字符串转换可能不够。此时可以编写自定义反序列化器：

public class DefaultUserDeserializer extends JsonDeserializer<UserRequest> {
    @Override
    public UserRequest deserialize(JsonParser p, DeserializationContext ctxt) 
            throws IOException {
        JsonNode node = p.getCodec().readTree(p);
        UserRequest req = new UserRequest();
        req.setNickname(
            node.has("nickname") ? node.get("nickname").asText() : "匿名用户"
        );
        req.setAge(node.has("age") ? node.get("age").asInt() : 18);
        return req;
    }
}

然后在Controller或DTO上使用@JsonDeserialize(using = DefaultUserDeserializer.class)。这种方法最灵活，但代码量较大，适合协议复杂或需要多层默认值链的场景。

方案四：Controller层默认值处理（不推荐）

部分开发者习惯在Controller方法参数中使用@RequestBody @Valid UserRequest user，然后在业务层用Optional.ofNullable(user.getNickname()).orElse("匿名用户")。这种方式虽然简单，但违背了“尽早处理缺失值”的原则，导致业务代码充满判空逻辑。对于Spring Boot 4项目，建议优先采用Jackson层面的默认值机制。

注意事项与最佳实践

  1. 全局配置需谨慎：全局启用Nulls.SKIP会影响所有请求体的解析。建议先在测试环境中验证，避免影响已有接口。
  2. 类型兼容性：defaultValue是字符串，Jackson会尝试将其转换为目标类型。对于Integer、Boolean等基本类型，确保字符串可被解析；对于复杂类型，可考虑自定义转换器。
  3. 与Hibernate Validator冲突：如果同时使用@Valid和Bean Validation注解（如@NotNull），需注意默认值会在验证前生效。若默认值为空字符串，而字段标注了@NotBlank，会抛出验证错误。应将默认值设置为合法值。
  4. 版本确认：Spring Boot 4与Jackson 3的集成目前仍在演进中。截至本文撰写时，@JsonProperty(defaultValue)的支持需使用Jackson 3.0.0以上版本。请检查pom.xml或build.gradle中的依赖版本。

总结

在Spring Boot 4 + Jackson 3的组合中，通过合理配置@JsonProperty(defaultValue)和@JsonSetter(nulls=Nulls.SKIP)，开发者可以优雅地解决请求体缺省字段的默认值问题。推荐优先使用方案一（全局配置）配合少数字段的二次注解，既能保持代码简洁，又能确保行为一致性。对于更复杂的默认值逻辑，自定义反序列化器仍是最终武器。希望本文能帮助读者在升级到Spring Boot 4时，更加自如地掌控JSON解析的细节。