Spring Boot Rest Service随机出现HTTP 400错误排查求助

首先，我注意到你代码里有个容易混淆的细节：@RequestParam(value = "id") String cuit —— 你指定了请求参数名为id，但变量名是cuit，语法上没问题，但这种命名不一致很容易在调试或协作时搞混，先把这个小坑提出来。

针对随机出现的400错误，我们一步步排查：

• 确认参数传递的一致性
  GET请求的id参数必须放在URL的query字符串里（比如/borrower?id=123）。随机报错大概率是某些请求没正确带上这个参数——比如前端在异步请求触发时机不对、缓存了旧的无参URL场景下漏传了参数。建议在客户端加个前置校验，确保每次请求都拼接上id参数。

• 修正代码里的参数命名混淆
  把参数定义改成和业务匹配的统一命名，避免自己和团队成员踩坑：

  // 如果业务参数名实际是cuit，就改成这个
  @RequestParam(value = "cuit") String cuit
  // 或者如果参数名确实是id，就统一变量名
  @RequestParam(value = "id") String id
  

• 添加参数容错与日志记录
  暂时给参数加上required=false和默认值，同时记录请求详情，下次报错时就能精准定位问题：

  @RequestMapping(path = "/borrower", method = RequestMethod.GET, produces = MediaType.APPLICATION_JSON_VALUE)
  @CrossOrigin(origins = "*")
  public ResponseEntity<?> borrower(
          @RequestParam(value = "id", required = false, defaultValue = "") String cuit,
          @RequestHeader("Authorization") String authHeader,
          HttpServletRequest request) {
      // 记录请求的关键信息
      log.info("Borrower request - URL: {}, Query params: {}, Auth header exists: {}",
              request.getRequestURL(), request.getParameterMap(), authHeader != null);
      // 参数为空时主动返回明确错误
      if (cuit.isEmpty()) {
          return ResponseEntity.badRequest().body("Parameter 'id' is required");
      }
      // 后续业务逻辑...
  }
  

  通过日志你能直接看到出错的请求是否真的没带参数，以及请求的其他细节。

• 排查客户端请求方式的问题
  确认所有请求都是GET方式，且参数确实放在URL里。如果某些客户端错误地用了POST方式，把参数放在请求体中，Spring的@RequestParam是不会解析请求体参数的，这也会导致参数缺失的错误。

• 检查代理/负载均衡的问题
  如果你用了反向代理或负载均衡器，偶尔可能出现转发请求时丢失query参数的情况。可以直接访问后端服务测试，对比通过代理访问的结果，排除这个可能性。

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