Spring Boot 不支持仅通过 consumes 属性差异对 @PostMapping 方法进行重载；必须使用不同方法名或统一入口 + 类型判别，以避免编译错误和运行时冲突。
spring boot 不支持仅通过 `consumes` 属性差异对 `@postmapping` 方法进行重载；必须使用不同方法名或统一入口 + 类型判别，以避免编译错误和运行时冲突。
在 Spring MVC 中，控制器方法的签名不能仅靠 @PostMapping 的 consumes 属性区分来实现重载。即使两个方法路径相同（如 /register）、HTTP 方法相同（POST），但 consumes = "application/x-www-form-urlencoded" 与 consumes = "application/json" 并不会被 Spring 视为“可重载”的不同方法——因为 Java 方法重载基于参数类型和数量，而 @PostMapping 是注解，不参与 JVM 方法签名；Spring 在启动时会因映射冲突（IllegalStateException: Ambiguous mapping）直接抛出异常。
✅ 正确做法有以下两种推荐方案：
方案一：使用语义化方法名（推荐）
为不同内容类型提供清晰、不可混淆的端点逻辑名称，既符合 REST 设计习惯，也便于测试与维护：
@PostMapping(path = "/register", consumes = MediaType.APPLICATION_FORM_URLENCODED_VALUE)
public ResponseEntity<user> registerFromForm(User user) {
User registered = userService.register(user);
URI location = ServletUriComponentsBuilder
.fromCurrentRequest()
.pathSegment("{id}")
.buildAndExpand(registered.getId())
.toUri();
return ResponseEntity.created(location).body(registered);
}
@PostMapping(path = "/register", consumes = MediaType.APPLICATION_JSON_VALUE)
public ResponseEntity<user> registerFromJson(@RequestBody User user) {
User registered = userService.register(user);
URI location = ServletUriComponentsBuilder
.fromCurrentRequest()
.pathSegment("{id}")
.buildAndExpand(registered.getId())
.toUri();
return ResponseEntity.created(location).body(registered);
}</user></user>
✅ 优势：无歧义、易测试、符合 Spring 最佳实践；IDE 和 Swagger 均能正确识别两个独立端点。
方案二：统一入口 + 内容类型动态解析（进阶）
若坚持单一方法名，可合并为一个方法，通过 HttpServletRequest 检查 Content-Type 并手动解析：
@PostMapping("/register")
public ResponseEntity<user> register(HttpServletRequest request) throws IOException {
String contentType = request.getContentType();
User user;
if (MediaType.APPLICATION_FORM_URLENCODED.toString().equalsIgnoreCase(contentType)) {
// 手动解析 form data（需谨慎，通常不推荐）
// 实际中建议用 @ModelAttribute 或保留独立方法
throw new UnsupportedOperationException("Form parsing not implemented here");
} else if (MediaType.APPLICATION_JSON.toString().equalsIgnoreCase(contentType)) {
String jsonBody = request.getReader().lines().collect(Collectors.joining("\n"));
user = new ObjectMapper().readValue(jsonBody, User.class);
} else {
return ResponseEntity.unsupportedMediaType().build();
}
User registered = userService.register(user);
URI location = ServletUriComponentsBuilder
.fromCurrentRequest()
.pathSegment("{id}")
.buildAndExpand(registered.getId())
.toUri();
return ResponseEntity.created(location).body(registered);
}</user>
⚠️ 注意：该方式绕过 Spring 默认绑定机制，丧失 @Valid、@InitBinder、类型转换等能力，仅作技术演示，不建议生产使用。
补充：单元测试建议
针对多 consumes 端点，可使用 MockMvc 分别验证：
@Test
void shouldRegisterUserFromJson() throws Exception {
mockMvc.perform(post("/register")
.contentType(MediaType.APPLICATION_JSON)
.content("{\"name\":\"Alice\",\"email\":\"a@example.com\"}"))
.andExpect(status().isCreated())
.andExpect(jsonPath("$.name").value("Alice"));
}
@Test
void shouldRegisterUserFromForm() throws Exception {
mockMvc.perform(post("/register")
.contentType(MediaType.APPLICATION_FORM_URLENCODED)
.param("name", "Bob")
.param("email", "b@example.com"))
.andExpect(status().isCreated())
.andExpect(jsonPath("$.name").value("Bob"));
}
? 总结：Spring Boot 不支持 consumes 驱动的方法重载。命名即契约——用 registerFromJson() 和 registerFromForm() 明确职责，比强行“重载”更安全、可读、可测。这是 Spring 社区广泛采纳的稳健实践。
