本文详解 spring boot + mongodb 应用中 delete 接口 400 错误的典型原因：路径变量（@pathvariable）误写为请求体（@requestbody），并提供完整修复步骤、代码示例与最佳实践。
本文详解 spring boot + mongodb 应用中 delete 接口 400 错误的典型原因：路径变量（@pathvariable）误写为请求体（@requestbody），并提供完整修复步骤、代码示例与最佳实践。
在 Spring Boot 构建 RESTful API 时，DELETE 请求通常通过 URL 路径传递资源 ID（如 /users/{id}），而非请求体（@RequestBody）。你当前的 UserResource.delete() 方法存在关键注解错误：
@DeleteMapping("/{id}")
public ResponseEntity<void> delete(@RequestBody String id) { // ❌ 错误：使用 @RequestBody
service.delete(id);
return ResponseEntity.noContent().build();
}</void>
该写法会导致 Spring 尝试从 HTTP 请求体（Body） 解析一个字符串 ID，但实际 DELETE 请求（如 Postman 中 DELETE http://localhost:8080/users/6449953dbd83981c4ca21358）并未携带任何请求体 —— ID 已作为路径变量（Path Variable）嵌入 URL。Spring 无法将空或格式不符的 Body 绑定为 String，因此抛出 400 Bad Request。
✅ 正确做法是使用 @PathVariable 明确声明 ID 来源于 URL 路径：
@DeleteMapping("/{id}")
public ResponseEntity<void> delete(@PathVariable String id) { // ✅ 正确：绑定路径变量
service.delete(id);
return ResponseEntity.noContent().build();
}</void>
同时，请确保 UserService.delete() 方法具备健壮性。当前实现先调用 findById(id) 校验存在性，再执行删除，逻辑合理；但建议补充日志与异常处理增强可观测性：
public void delete(String id) {
findById(id); // 触发 ObjectNotFoundException（若不存在）
repo.deleteById(id);
log.info("User deleted successfully: {}", id); // 可选：添加日志
}
⚠️ 注意事项：
-
MongoDB ID 格式校验：虽然 ObjectId 字符串可直接传入 repo.deleteById()，但若传入非法格式（如 "abc"），repository.findById() 会因 ObjectId.isValid("abc") == false 导致 EmptyResultDataAccessException。建议在 findById() 前增加格式预检（可选）：
if (!ObjectId.isValid(id)) { throw new ObjectNotFoundException("Invalid ObjectId format: " + id); } - HTTP 状态码语义：ResponseEntity.noContent().build() 返回 204 No Content，符合 REST 规范；若需返回被删资源快照，可改为 ResponseEntity.ok().body(new UserDTO(deletedUser))。
- Postman 测试要点：确保请求方法为 DELETE，URL 完整包含 ID（如 http://localhost:8080/users/6449953dbd83981c4ca21358），且不填写 Body（Body 标签页应为空或设为 none）。
修复后，重启应用，再次通过 Postman 发送 DELETE 请求即可成功删除用户，并返回 204 No Content 状态码。此问题本质是 Spring MVC 参数绑定机制的理解偏差，掌握 @PathVariable、@RequestParam、@RequestBody 的适用场景，是构建可靠 REST API 的基础。
