Spring中如何为@RequestBody字段设置类似@RequestParam的默认值

你遇到的空值覆盖默认值问题，核心是Spring参数绑定逻辑和POJO赋值规则的冲突，两种无效写法的原因：

• 直接给字段赋初始值不生效：只要请求URL携带了对应参数（哪怕参数值是空串，比如pageSize=），Spring数据绑定组件就会触发字段赋值流程，空串转包装类型Short的结果是null，这个null会直接覆盖类中定义的初始值。
• 字段加@Value不生效：@Value是Spring容器初始化托管Bean时用来注入配置属性的注解，请求参数对应的POJO是每次请求触发时临时创建的绑定对象，不经过容器属性注入流程，该注解在这个场景下完全无效。

另外需要明确：你演示的GET请求传查询参数的场景，Spring默认按@ModelAttribute规则做参数绑定，并非@RequestBody（@RequestBody用于解析HTTP请求体中的JSON/XML等格式内容），两类场景的默认值实现方案有区别。你之前测试有效的@RequestParam(defaultValue=...)写法，是因为Spring原生参数解析器在解析到参数为空时，会直接用配置的默认值做类型转换，不会传递null到赋值环节，因此不会出现默认值被覆盖的问题。

场景1：查询参数/表单参数绑定POJO（你当前遇到的场景） #

方案1：自定义字段setter做非空判断（无额外依赖，最灵活） #

自己编写字段的setter方法，覆盖Lombok自动生成的setter，仅当传入值非null时才覆盖初始默认值：

// Uses Lombok @Data
public class RetrieveTxnRequest {

  private Short pageStart = 0;
  private Short pageSize = Short.MAX_VALUE;

  // 手动编写setter，null值不覆盖默认值
  public void setPageStart(Short pageStart) {
    if (pageStart != null) {
      this.pageStart = pageStart;
    }
  }

  public void setPageSize(Short pageSize) {
    if (pageSize != null) {
      this.pageSize = pageSize;
    }
  }
}

这种写法不需要额外配置，对当前绑定类即时生效。

方案2：参数较少时直接在Controller方法上声明@RequestParam #

如果POJO字段不多，直接用你之前测试生效的@RequestParam写法即可，defaultValue逻辑由Spring原生参数解析器实现，稳定性最高：

@GetMapping("/ourEndpoint")
public OurResponse getTransactions(
  @RequestParam(required = false, defaultValue = "0") Short pageStart,
  @RequestParam(required = false, defaultValue = "32767") Short pageSize
) {
  RetrieveTxnRequest req = new RetrieveTxnRequest();
  req.setPageStart(pageStart);
  req.setPageSize(pageSize);
  // 执行业务逻辑
}

场景2：使用@RequestBody接收JSON格式请求体 #

@RequestBody的参数解析默认由Jackson反序列化实现，遇到null值覆盖默认值的问题可以通过Jackson的配置解决：

方案1：字段级别配置跳过null值 #

给需要保留默认值的字段添加@JsonSetter(nulls = Nulls.SKIP)注解，反序列化遇到null值时直接跳过，保留字段初始值：

import com.fasterxml.jackson.annotation.JsonSetter;
import com.fasterxml.jackson.annotation.Nulls;
import lombok.Data;

@Data
public class RetrieveTxnRequest {
  private Short pageStart = 0;

  @JsonSetter(nulls = Nulls.SKIP)
  private Short pageSize = Short.MAX_VALUE;
}

方案2：全局配置Jackson反序列化规则 #

如果需要所有请求体绑定类都默认跳过null值覆盖，可以全局配置ObjectMapper规则，不需要每个字段单独加注解：

import com.fasterxml.jackson.annotation.JsonSetter;
import com.fasterxml.jackson.annotation.Nulls;
import com.fasterxml.jackson.databind.ObjectMapper;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class JacksonConfig {
  @Bean
  public ObjectMapper objectMapper() {
    ObjectMapper objectMapper = new ObjectMapper();
    // 配置Short类型反序列化时遇到null值跳过，保留默认值
    objectMapper.configOverride(Short.class)
      .setSetterInfo(JsonSetter.Value.forValueNulls(Nulls.SKIP));
    // Integer、Long、String等其他需要支持的类型可按相同规则添加配置
    return objectMapper;
  }
}

注意：@RequestParam的defaultValue能力是Spring MVC参数解析器单独实现的逻辑，POJO参数绑定场景没有完全等价的开箱即用注解，上述方案都可以实现相同的默认值兜底效果。

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