@RequestParam 可选参数设置方法

在Spring MVC开发中，@RequestParam默认要求参数必须存在，一旦缺失就会触发400错误，导致接口僵硬难用；本文详解如何通过设置required = false将参数设为可选，并灵活结合null安全判断或defaultValue指定默认值，既避免异常中断、又提升API的兼容性与健壮性——掌握这一技巧，让你的RESTful接口轻松支持多变的调用场景，写出更优雅、更可靠的控制器代码。

在 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 的健壮性与易用性。

以上就是《@RequestParam 可选参数设置方法》的详细内容，更多关于的资料请关注golang学习网公众号！