
在 spring mvc 中,可通过为 @requestparam 添加 required = false 属性,使其变为可选参数;当请求未携带该参数时,其值将为 null(或通过 defaultvalue 指定默认值),从而避免 400 bad request 错误。
在 spring mvc 中,可通过为 @requestparam 添加 required = false 属性,使其变为可选参数;当请求未携带该参数时,其值将为 null(或通过 defaultvalue 指定默认值),从而避免 400 bad request 错误。
在开发 RESTful 接口时,常遇到某些查询参数并非始终必需的场景。例如,实现字符串拼接接口 /concat,期望支持单参数(仅 c1)和双参数(c1 + c2)两种调用方式。若直接使用 @RequestParam("c2") String con2,Spring 默认将其视为必填项,一旦客户端未传 c2,将立即返回 HTTP 400 错误(Required request parameter 'c2' is not present),根本不会进入控制器方法体——因此你尝试的空值判断逻辑根本不会执行。
✅ 正确做法是显式声明该参数为可选:
@GetMapping("/concat")
public String conc(
@RequestParam("c1") String con1,
@RequestParam(name = "c2", required = false) String con2) {
// con2 为 null 时,可安全做空值处理(如转为空字符串)
String second = (con2 != null) ? con2 : "";
return stringService.conc(con1, second);
}
⚠️ 注意事项:
- required = false 是关键配置,缺省值为 true;
- 当参数缺失时,con2 将被注入为 null(非空字符串),因此需主动判空,避免 NPE;
- 如希望缺失时自动赋予默认值(如空字符串),可改用 defaultValue = "":
@RequestParam(name = "c2", defaultValue = "") String con2
此时 con2 永不为 null,更利于后续逻辑简化;
- 若同时设置 required = false 和 defaultValue,后者会覆盖前者的行为(即参数缺失时取默认值,而非 null);
- 不建议依赖全局 @ExceptionHandler 处理此类问题——它属于异常兜底机制,而 required = false 是语义清晰、性能更优的正向设计。
总结:让 @RequestParam 可选,核心在于 required = false;结合合理的空值/默认值处理,即可优雅支持灵活的参数组合,提升 API 的健壮性与易用性。










