当前位置： 首页 > web >正文

Spring Boot 中修改 HTTP 响应状态码（即 `response.status`）可以通过以下几种方式实现

web 2025/8/4 18:03:59

以下是不同场景下的具体方法：

方法 1：直接使用 @ResponseStatus 注解

在 Controller 方法或异常类上使用 @ResponseStatus 注解，直接指定返回的状态码。

场景示例：固定返回指定状态码
import org.springframework.http.HttpStatus;
import org.springframework.web.bind.annotation.ResponseStatus;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RestController;@RestController
public class MyController {// 成功创建资源时返回 201@PostMapping("/create")@ResponseStatus(HttpStatus.CREATED) // 状态码 201public String createResource() {return "Resource created";}
}

方法 2：动态返回 ResponseEntity 对象

通过 ResponseEntity 对象在代码中动态控制状态码，适用于需要根据业务逻辑返回不同状态码的场景。

场景示例：根据条件返回不同状态码
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RestController;@RestController
public class MyController {@GetMapping("/user/{id}")public ResponseEntity<String> getUser(@PathVariable Long id) {if (id == 1) {return ResponseEntity.ok("User found"); // 默认 200} else {return ResponseEntity.status(HttpStatus.NOT_FOUND).body("User not found"); // 404}}
}

方法 3：通过全局异常处理统一修改状态码

使用 @ControllerAdvice 和 @ExceptionHandler 拦截异常并统一设置状态码。

场景示例：资源不存在时返回 404
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseStatus;
import org.springframework.web.bind.annotation.ControllerAdvice;
import javax.persistence.EntityNotFoundException;@ControllerAdvice
public class GlobalExceptionHandler {// 捕获 EntityNotFoundException 并返回 404@ExceptionHandler(EntityNotFoundException.class)@ResponseStatus(HttpStatus.NOT_FOUND)public String handleEntityNotFound() {return "Resource not found";}
}

方法 4：直接操作 HttpServletResponse

在 Controller 方法中注入 HttpServletResponse 对象，直接设置状态码。

场景示例：手动设置状态码
import javax.servlet.http.HttpServletResponse;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;@RestController
public class MyController {@GetMapping("/manual")public String manualStatus(HttpServletResponse response) {response.setStatus(HttpStatus.ACCEPTED.value()); // 状态码 202return "Status manually set";}
}

常见场景与状态码对照表

场景推荐状态码说明
成功200 OK默认成功状态码
创建资源成功201 Created配合 @PostMapping 使用
请求参数错误400 Bad Request客户端请求错误
未授权访问401 Unauthorized需要身份验证
禁止访问403 Forbidden无权限访问资源
资源不存在404 Not Found请求的资源不存在
服务器内部错误500 Internal Error未捕获的异常导致服务器错误

注意事项

  1. 优先级问题
    ResponseEntity 的优先级高于 @ResponseStatus，如果二者同时存在，以 ResponseEntity 为准。

  2. 直接操作 HttpServletResponse 的限制
    如果在设置状态码后修改响应体，可能导致 IllegalStateException，建议优先使用 Spring 提供的抽象（如 ResponseEntity）。

  3. 全局异常处理的覆盖范围
    通过 @ControllerAdvice 可以统一处理所有 Controller 抛出的异常，适合集中管理错误状态码。

通过上述方法，你可以根据具体场景灵活控制 HTTP 响应的状态码。推荐优先使用 ResponseEntity 或 @ResponseStatus 保持代码简洁。
以下是结合自定义返回工具类与 Spring Boot 状态码控制的详细方案，提供代码示例和分步说明：

1. 定义统一返回结果工具类

public class ApiResponse<T> {private int code;       // 业务状态码（非 HTTP 状态码）private String message; // 提示信息private T data;         // 返回数据// 快速创建成功响应（静态工厂方法）public static <T> ApiResponse<T> success(T data) {return new ApiResponse<>(200, "Success", data);}// 快速创建失败响应（链式调用支持）public static ApiResponse<Void> failure(int code, String message) {return new ApiResponse<>(code, message, null);}public ApiResponse<T> code(int code) {this.code = code;return this;}public ApiResponse<T> message(String message) {this.message = message;return this;}// 构造方法、Getter 省略...
}

2. 与状态码控制方法结合使用

场景 1：固定状态码 + 统一数据结构（@ResponseStatus）
@PostMapping("/users")
@ResponseStatus(HttpStatus.CREATED) // 强制 HTTP 201
public ApiResponse<User> createUser(@RequestBody User user) {User savedUser = userService.save(user);return ApiResponse.success(savedUser).message("User created successfully");
}
场景 2：动态状态码 + 统一数据结构（ResponseEntity）
@GetMapping("/products/{id}")
public ResponseEntity<ApiResponse<Product>> getProduct(@PathVariable Long id) {return productService.findById(id).map(product -> ResponseEntity.ok(ApiResponse.success(product)) // HTTP 200).orElseGet(() -> ResponseEntity.status(HttpStatus.NOT_FOUND).body(ApiResponse.failure(404, "Product not found")));
}

3. 全局异常处理统一包装结果

@ControllerAdvice
public class GlobalExceptionHandler {// 处理业务异常（HTTP 400 + 自定义错误码）@ExceptionHandler(BusinessException.class)public ResponseEntity<ApiResponse<Void>> handleBusinessException(BusinessException ex) {return ResponseEntity.badRequest() // HTTP 400.body(ApiResponse.failure(ex.getCode(), ex.getMessage()));}// 处理资源不存在（HTTP 404）@ExceptionHandler(ResourceNotFoundException.class)public ResponseEntity<ApiResponse<Void>> handleResourceNotFound(ResourceNotFoundException ex) {return ResponseEntity.status(HttpStatus.NOT_FOUND).body(ApiResponse.failure(404, ex.getMessage()));}// 兜底异常处理（HTTP 500）@ExceptionHandler(Exception.class)public ResponseEntity<ApiResponse<Void>> handleGlobalException(Exception ex) {return ResponseEntity.internalServerError().body(ApiResponse.failure(500, "Internal server error"));}
}

4. 进阶工具类（支持链式设置 HTTP 状态码）

public class ApiResponseBuilder<T> {private HttpStatus httpStatus = HttpStatus.OK; // 默认 200private ApiResponse<T> apiResponse;private ApiResponseBuilder(ApiResponse<T> apiResponse) {this.apiResponse = apiResponse;}public static <T> ApiResponseBuilder<T> success(T data) {return new ApiResponseBuilder<>(ApiResponse.success(data));}public ApiResponseBuilder<T> httpStatus(HttpStatus status) {this.httpStatus = status;return this;}public ResponseEntity<ApiResponse<T>> build() {return ResponseEntity.status(httpStatus).body(apiResponse);}
}// 使用示例
@PostMapping("/orders")
public ResponseEntity<ApiResponse<Order>> createOrder() {Order newOrder = orderService.create();return ApiResponseBuilder.success(newOrder).httpStatus(HttpStatus.CREATED) // 设置 HTTP 201.build();
}

5. 关键注意事项

  1. 明确区分两类状态码

    • HTTP 状态码：描述网络请求结果（200/404/500）
    • 业务状态码：描述业务逻辑结果（如 1001=库存不足）

  2. 推荐优先级

    • 优先使用 ResponseEntity 控制 HTTP 状态码
    • 使用工具类封装业务状态码

  3. 保持响应结构一致性

    // 成功示例
{"code": 200,"message": "Success","data": { "id": 1, "name": "test" }
}// 错误示例（HTTP 404）
{"code": 40401,"message": "Product not found","data": null
}

通过这种方式，您既可以精准控制 HTTP 协议层的状态码，又能通过工具类统一业务响应格式，同时保持代码的高度可维护性。

http://www.xdnf.cn/news/8679.html

相关文章：

  • springboot 多模块，打包为一个jar包
  • 1.4 TypeScript 编译是如何工作的？
  • Maven：在原了解基础上对pom.xml文件进行详细解读
  • Web安全技术体系
  • 恢复二叉搜索树：递归与中序遍历的智慧应用
  • [创业之路-374]：企业战略管理案例分析-战略制定/设计-市场洞察“五看”：看宏观之当前的国际环境、国家产业政策中的机会与风险
  • Redis学习打卡-Day6-Redis 高可用（上）
  • 在Visual Studio中进行cuda编程
  • Spark 中，创建 DataFrame 的方式（Scala语言）
  • 最宽温度范围文本格式PT1000分度表-200~850度及PT1000铂电阻温度传感器计算公式
  • Linux常用命令学习指南： 基础教程与实战应用
  • 【DAY28】类的定义和方法
  • H3C-W2000-G2【透明代理模式】
  • day11制作窗口（鼠标显示、图层和图层控制器、显示窗口、高速计数器、消除闪烁）
  • 力扣热题100之排序链表
  • 电脑网络如何改ip地址？ip地址改不了怎么回事
  • 白杨SEO：做AI搜索优化的DeepSeek、豆包、Kimi、百度文心一言、腾讯元宝、通义、智谱、天工等AI生成内容信息采集主要来自哪？占比是多少？
  • Microsoft.ClearScript.V8单例模式封装，方便下次使用。
  • Android12 launcher3修改App图标白边问题
  • Linux命令简介
  • 过滤器和拦截器的区别
  • web常见的攻击方式有哪些？如何防御？
  • 防止误触的手机锁屏实用工具
  • 跨平台兼容Setup PDF 编辑器页面合并拆分OCR 识别支持多语言
  • Jenkins的Pipline中有哪些区块,以及其它知识点整理
  • 【 大模型技术驱动智能网联汽车革命：关键技术解析与未来趋势】
  • 安全基础与协议分析
  • 静态分配动态绑定
  • 数据的获取与读取篇---常见的数据格式JSON
  • 一张纸决定的高度