responseentity 是 spring boot 中控制响应体、状态码和响应头的核心类型，应通过其静态方法或构造器精准设置状态码，而非自定义类；结合 @responsestatus、统一 result 包装和 @controlleradvice 可实现规范化的 http 状态码管理。
在 Spring Boot 中，ResponseEntity 是最常用、最灵活的返回类型之一，它让你能**同时控制响应体（body）、HTTP 状态码（status）和响应头（headers）**。要精准控制状态码，关键不是“自定义” ResponseEntity 类，而是**正确构造和返回它的实例**。
直接使用 ResponseEntity 构造器或静态方法
Spring 提供了多种便捷方式创建 ResponseEntity，避免手动 new，语义更清晰：
-
带状态码和响应体：
ResponseEntity.ok("success")→ 200；ResponseEntity.badRequest().body("参数错误")→ 400；ResponseEntity.status(HttpStatus.CREATED).body(user)→ 201 -
带自定义状态码（含原因短语）：
ResponseEntity.status(422).body("校验失败")或ResponseEntity.status(HttpStatus.valueOf(422)).body(...) -
仅状态码无响应体：
return ResponseEntity.noContent().build();（204）或ResponseEntity.notFound().build()（404）
结合 @ResponseStatus 注解（适用于固定状态码场景）
如果某个接口**总是返回同一状态码**（比如删除成功固定返回 204），可在方法上加 @ResponseStatus，简化代码：
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
@DeleteMapping("/users/{id}")
@ResponseStatus(HttpStatus.NO_CONTENT)
public void deleteUser(@PathVariable Long id) {
// 业务逻辑
}
注意：此时方法返回类型应为 void 或 ResponseEntity<void></void>，否则 @ResponseStatus 不生效。
封装通用响应结构时保留状态码控制权
很多项目会定义统一的 Result<t></t> 包装类（如 {"code":200,"msg":"OK","data":{...}}），但这类包装**不能替代 HTTP 状态码**。正确做法是：
- 仍用
ResponseEntity<result>></result>作为返回类型 - 根据业务结果动态设置状态码：
ResponseEntity.ok(Result.success(user))、ResponseEntity.status(HttpStatus.UNAUTHORIZED).body(Result.error("未登录")) - 避免所有接口都返回 200 + 自定义 code 字段 —— 这违背 REST 原则，前端无法利用 HTTP 状态码做统一错误拦截
处理异常时用 @ControllerAdvice 统一返回状态码
对于全局异常（如参数校验失败、空指针、业务异常），推荐用 @ControllerAdvice + @ExceptionHandler 统一返回对应状态码：
@ExceptionHandler(MethodArgumentNotValidException.class)
public ResponseEntity
return ResponseEntity.badRequest().body(Result.error("参数校验失败")); // 400
}
@ExceptionHandler(UserNotFoundException.class)
public ResponseEntity
return ResponseEntity.status(HttpStatus.NOT_FOUND).body(Result.error(e.getMessage())); // 404
}
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
