Spring @RequestParam报错isNonLocked String类型参数不存在如何解决？

你遇到的报错本质是Spring未从请求的查询参数/表单参数中匹配到名为isNonLocked的参数，和该参数的接收类型是String还是Boolean无关。

• 传参参数名不匹配：调用方传递的参数名和@RequestParam指定的isNonLocked未完全一致，常见的错误是大小写拼写错误（如写成isnonlocked/IsNonLocked）、多打或少打字符，或者参数名前后带有多余空格。
• 传参位置错误：@RequestParam只能解析URL拼接的查询参数、form-data/x-www-form-urlencoded格式的表单参数，如果你把参数放在JSON请求体里传递，@RequestParam无法读取，会直接判定参数缺失。
• 特殊场景截断：如果是GET请求或者URL参数过长，可能被服务端/网关的URL长度限制规则截断，导致末尾的isNonLocked参数丢失。

• 优先排查调用方传参：
  1. 确认参数名严格和isNonLocked完全一致，无拼写错误
  2. 确认参数传递位置符合要求：要么拼接在请求URL后，要么放在表单类型的请求体中，不要放在JSON请求体内
• 如果该参数允许不传，可修改注解配置为非必填并设置默认值，示例：

  // required = false表示参数非必填，defaultValue指定没传时的默认值
  @RequestParam(value = "isNonLocked", required = false, defaultValue = "false") String isNonLocked
  

• 如果业务上就是要通过JSON体传递所有参数，可把参数封装为一个DTO实体类，改用@RequestBody注解接收：

  // 先定义DTO
  @Data
  public class UserUpdateDTO {
      private String currentUsername;
      private String username;
      private String email;
      private String role;
      private String isActive;
      private String isNonLocked;
  }
  
  // 接口修改为
  @PutMapping("/update")
  public ResponseEntity<User> update(@RequestBody UserUpdateDTO updateDTO) throws Exception {
      // 原有业务逻辑不变
  }
  

• 排查阶段可开启Spring Web debug日志，确认后端实际收到的请求参数：在项目配置文件中添加logging.level.org.springframework.web=DEBUG，启动后即可在日志中看到完整的请求参数列表，确认isNonLocked是否真的传递到了后端。

内容的提问来源于stack exchange，提问作者Mohamad J Alanbaki