在 spring boot 中返回 http 状态码最直接的方式是使用 @responsestatus 注解或让控制器方法抛出对应的异常,框架会自动将状态码写入响应头。若需根据业务逻辑动态决定状态码,应使用 responseentity 包装返回值,通过其构造器指定具体的 httpstatus 枚举值。对于需要同时返回错误详情和状态码的场景,推荐结合自定义异常与全局异常处理器进行统一拦截处理。

如何使用 ResponseEntity 动态设置状态码
当需要根据业务结果(如创建成功、更新失败)返回不同的状态码时,应使用 ResponseEntity 对象作为控制器的返回类型。该对象允许显式设置状态码、头部信息和响应体,从而实现对 HTTP 响应的完全控制。例如,在资源创建成功后返回 201 Created,或在参数校验失败时返回 400 Bad Request。

import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;
@RestController
public class UserController {
@PostMapping("/users")
public ResponseEntity<string> createUser(@RequestBody String userJson) {
// 模拟业务逻辑:假设用户创建成功
boolean success = true;
if (success) {
// 返回 201 Created,并携带位置信息
return ResponseEntity
.status(201)
.header("Location", "/users/1")
.body("User created successfully");
} else {
// 返回 400 Bad Request
return ResponseEntity
.badRequest()
.body("Invalid input data");
}
}
}</string>
如何通过异常映射自动返回状态码
除了手动构建响应,Spring Boot 支持通过抛出特定异常来自动触发状态码返回。可以使用 @ResponseStatus 注解标记自定义异常类,或者使用 @ExceptionHandler 方法捕获异常并返回 ResponseEntity。这种方式将错误处理逻辑从业务代码中解耦,使控制器方法保持简洁。例如,定义一个 ResourceNotFoundException,当抛出该异常时,框架自动返回 404 Not Found。

import org.springframework.http.HttpStatus;
import org.springframework.web.bind.annotation.*;
import org.springframework.http.ResponseEntity;
@RestController
public class ExceptionController {
@GetMapping("/items/{id}")
public String getItem(@PathVariable Long id) {
// 模拟未找到资源的情况
if (id == 999) {
throw new RuntimeException("Item not found");
}
return "Item details";
}
@ExceptionHandler(RuntimeException.class)
public ResponseEntity<string> handleNotFound(RuntimeException ex) {
// 捕获异常并返回 404 状态码
return ResponseEntity
.status(HttpStatus.NOT_FOUND)
.body(ex.getMessage());
}
}</string>
基于程序中某个输入、条件或结果的具体问题
在上述 createUser方法中,当 userJson 为空字符串时,程序会进入 else 分支并返回 400 状态码。这是因为 success 变量被硬编码为 true,但在实际业务中,空输入会导致业务逻辑判断失败。若修改 success 的判断逻辑,例如检查输入是否为空,则只有非空输入才会返回 201,否则返回 400。这种条件分支直接决定了最终返回的 HTTP 状态码,开发者需确保业务逻辑与状态码语义一致。
,











