为何@GetMapping("/")无法生效，而@GetMapping("")可正常运行？

一、GetMapping参数绑定问题排查 #

• 确认参数注解使用正确：
  • URL路径参数需用@PathVariable，示例：

    @GetMapping("/user/{id}")
    public String getUser(@PathVariable Long id) {
        // 逻辑代码
    }
    

  • 请求参数需用@RequestParam，非必填参数要加required = false，示例：

    @GetMapping("/user")
    public String getUserList(@RequestParam(value = "page", required = false, defaultValue = "1") Integer page) {
        // 逻辑代码
    }
    

• 核对参数类型匹配：确保URL传入的参数值和方法参数类型一致，避免因类型转换失败导致请求无法匹配。
• 查看注册日志：启动应用时，搜索控制台中RequestMappingHandlerMapping的输出，确认带参数的GetMapping是否被正确注册到容器中。

二、PostMapping表单路径问题修复 #

• 明确表单action路径：使用完整的相对路径（含应用上下文）或绝对路径，比如应用上下文为/demo，表单action应写为/demo/user/submit，而非仅user/submit。
• 借助Spring标签生成路径：在模板文件（如Thymeleaf）中使用th:action="@{/user/submit}"，Spring会自动拼接应用上下文路径，避免手动编写错误。
• 校验PostMapping路径一致性：确保@PostMapping注解的路径与表单action完全匹配，注意路径开头的斜杠不要遗漏。

三、环境与缓存问题排查 #

• 检查Spring依赖版本：不同版本的Spring MVC路径匹配规则存在差异，建议使用官方稳定版本，避免因版本兼容问题导致映射异常。
• 清理项目构建缓存：执行Maven命令mvn clean install或Gradle命令gradle clean build，清除旧编译文件，排除缓存干扰。
• 核对路径匹配配置：查看application.properties或application.yml中的spring.mvc.pathmatch.matching-strategy配置，确认其设置符合项目需求（可选值为ant_path_matcher或path_pattern_parser）。

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