Spring @PathVariable注解不生效，访问带路径参数页面失败

1. 页面无法加载的排查与修复 #

• 访问路径错误：你的@GetMapping配置的是绝对路径/update-password/{id}，测试时必须使用绝对路径（如http://localhost:8080/update-password/test），而非相对路径../update-password/test——相对路径会根据当前页面上下文解析，很可能指向错误的地址。
• 模板文件位置验证：确认updatePassword模板文件（如updatePassword.html）放在Spring Boot默认的模板目录下（比如Thymeleaf对应的src/main/resources/templates/），路径错误会导致框架找不到页面。
• 静态资源检查：如果页面依赖CSS、JS等资源，确保这些资源的引用路径正确，避免因资源404导致页面渲染失败。

2. @PostMapping是否需要添加@PathVariable？ #

需要根据业务逻辑调整，更合理的做法是给@PostMapping也加上@PathVariable，同时修复线程不安全的问题：

• 你的currentUser是Controller的成员变量，而Controller是单例的，多用户同时访问时会互相覆盖这个变量，引发数据混乱。必须通过@PathVariable的id从数据库或Session中获取当前用户。
• 修改后的PostMapping示例：

  @PostMapping("/update-password/{id}")
  public String submitEmail(@PathVariable String id,
          @RequestParam("password") String password,
          @Validated UpdatePasswordForm updatePasswordForm,
          BindingResult bindingResult,
          Model model,
          HttpServletResponse httpServletResponse,
          HttpServletRequest request) {
      // 通过id获取用户，替代线程不安全的成员变量currentUser
      currentUser = userService.getUserById(id)
              .orElseThrow(() -> new IllegalArgumentException("无效的用户ID"));
  
      model.addAttribute("httpServletRequest", request);
  
      if (bindingResult.hasErrors()) {
          httpServletResponse.setStatus(HttpServletResponse.SC_BAD_REQUEST);
          model.addAttribute("submitted_form", null);
          return "updatePassword";
      }
  
      currentUser.setPassword(password);
      userService.updateOrAddUser(currentUser);
  
      return "login";
  }
  

• 同时要修改页面表单的action属性，确保提交路径带上id，比如Thymeleaf模板中可以这样写：

  <form th:action="@{/update-password/{id}(id=${id})}" method="post">
      <!-- 表单字段 -->
  </form>
  

3. HttpRequestMethodNotSupportedException报错解决 #

这个报错是因为有GET请求访问了仅支持POST的/update-password路径：

• 检查是否有用户直接在浏览器地址栏输入/update-password并回车（这是GET请求），可以给该路径添加一个@GetMapping做跳转或提示，比如：

  @GetMapping("/update-password")
  public String redirectToUpdatePassword() {
      // 跳转到默认页面或提示用户输入正确路径
      return "redirect:/login";
  }
  

• 确认页面表单的method属性设置为post，如果写成get，提交时会用GET方法访问/update-password，触发报错。确保表单代码为<form method="post">。

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