在Spring Boot RestController中应使用boolean还是Boolean？

核心区别 #

• 空值处理差异
  当@RequestParam设置required = false时：
  • 用基本类型boolean：如果请求里没传filterMode参数，Spring无法将null（无参时的默认值）赋值给基本类型，会直接抛出400 Bad Request异常。
  • 用包装类型Boolean：无参时参数会被赋值为null，能明确区分「用户未传参」和「用户传了false」两种场景。
• 状态表达能力
  基本类型boolean只有true/false两种状态；包装类型Boolean支持null/true/false三种状态，能覆盖更多业务场景（比如判断用户是否主动设置过该参数）。

最佳实践 #

• 若业务需要区分「用户未传参」和「主动传false」，必须用Boolean包装类型。
• 若确定该参数必须传，可以用基本类型boolean，但此时建议把required设为true（默认就是true，可省略），避免无参时的异常。
• 只要参数允许不传（required = false），优先用Boolean，既能避免异常，也能保留更丰富的状态信息。

示例修正（避免无参时报错）：

@GetMapping
public NOTMATTER getResultByBoolean(
 @RequestParam(value = "filterMode", required = false) Boolean filterMode) {
  // 业务逻辑中可判断filterMode是否为null，区分未传参场景
}

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