Spring Boot应用启动失败：请求映射歧义问题排查与解决

问题根源 #

你的AuthController中两个handleFormSubmission方法都映射到了POST /auth，一个无参、一个带String参数，Spring无法区分这两个请求映射规则，直接导致Bean创建失败，触发Application run failed Error 18237。

快速解决办法 #

下面三种方案任选其一，都能快速解决映射冲突问题：

1. 修改其中一个方法的映射路径

给两个方法设置不同的POST路径，从根源上避免冲突：

@Controller
@RequestMapping("/auth")
public class AuthController {

    // 无参方法保留原路径
    @PostMapping
    public String handleFormSubmission() {
        // 你的业务逻辑
        return "redirect:/home";
    }

    // 带参数方法修改为新路径
    @PostMapping("/submit-with-username")
    public String handleFormSubmission(@RequestParam("username") String username) {
        // 你的业务逻辑
        return "redirect:/dashboard";
    }
}

2. 通过请求参数区分映射

如果不想修改路径，可以用params属性指定匹配条件，让Spring根据请求是否包含特定参数来区分方法：

@Controller
@RequestMapping("/auth")
public class AuthController {

    // 仅当请求不含username参数时匹配
    @PostMapping(params = "!username")
    public String handleFormSubmission() {
        // 你的业务逻辑
        return "redirect:/home";
    }

    // 仅当请求包含username参数时匹配
    @PostMapping(params = "username")
    public String handleFormSubmission(@RequestParam("username") String username) {
        // 你的业务逻辑
        return "redirect:/dashboard";
    }
}

3. 通过请求内容类型区分

如果参数是放在请求体里的，可以用consumes属性按内容类型区分：

@Controller
@RequestMapping("/auth")
public class AuthController {

    // 处理表单提交（默认application/x-www-form-urlencoded）
    @PostMapping(consumes = MediaType.APPLICATION_FORM_URLENCODED_VALUE)
    public String handleFormSubmission() {
        // 你的业务逻辑
        return "redirect:/home";
    }

    // 处理JSON格式的请求体
    @PostMapping(consumes = MediaType.APPLICATION_JSON_VALUE)
    public String handleFormSubmission(@RequestBody String payload) {
        // 你的业务逻辑
        return "redirect:/dashboard";
    }
}

验证步骤 #

修改代码后重新启动Spring Boot应用，查看日志确认没有Application run failed错误，之后访问localhost:8080测试对应接口是否正常响应即可。

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