在 java 自定义异常中关联 http 状态码,最直接的做法是在异常类中定义一个 statuscode 字段并提供对应的 getter 方法。这样可以在捕获异常时直接获取状态码,无需通过字符串解析或硬编码映射。通常结合 spring boot 的 @controlleradvice 和 @exceptionhandler 注解,将异常转换为标准的 json 响应并设置正确的 http 状态码。

如何设计支持状态码的自定义异常类
设计自定义异常类时,需要继承 RuntimeException 以支持非受检异常抛出,并添加 statusCode 属性。构造函数应接受状态码、错误消息和可选的原始异常(cause),以便完整保留堆栈信息。这种设计允许业务逻辑层抛出带有明确语义的状态码异常,而无需在控制器层进行繁琐的判断。

public class HttpException extends RuntimeException {
private final int statusCode;
public HttpException(int statusCode, String message) {
super(message);
this.statusCode = statusCode;
}
public HttpException(int statusCode, String message, Throwable cause) {
super(message, cause);
this.statusCode = statusCode;
}
public int getStatusCode() {
return statusCode;
}
}
上述代码定义了一个基础的 HttpException 类。它包含两个构造函数:一个用于简单错误提示,另一个用于包裹底层异常。关键点是 statusCode 字段被标记为 final,确保不可变性。在实际使用中,可以创建具体子类如 NotFoundException 或 UnauthorizedException,它们只需调用父类构造函数并传入固定的状态码(如 404 或 401),从而简化业务代码中的异常抛出逻辑。
如何在 Spring Boot 中统一处理异常并返回状态码
在 Spring Boot 应用中,使用 @RestControllerAdvice 全局拦截器来捕获自定义异常。在处理方法中,通过 ResponseEntity 对象构建响应,利用异常对象的 getStatusCode() 方法动态设置 HTTP 状态码。这种方式确保了所有异常都能以一致的格式返回给客户端,且状态码准确反映错误类型。

@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(HttpException.class)
public ResponseEntity<map object>> handleHttpException(HttpException ex) {
Map<string object> body = new HashMap();
body.put("error", ex.getMessage());
body.put("status", ex.getStatusCode());
return ResponseEntity.status(ex.getStatusCode()).body(body);
}
@ExceptionHandler(Exception.class)
public ResponseEntity<map object>> handleGenericException(Exception ex) {
Map<string object> body = new HashMap();
body.put("error", "Internal Server Error");
body.put("status", 500);
return ResponseEntity.status(500).body(body);
}
}</string></map></string></map>
这段代码展示了全局异常处理器的实现。handleHttpException 方法专门处理自定义的 HttpException,它提取异常中的状态码和消息,并通过 ResponseEntity.status() 设置响应状态。第二个方法 handleGenericException 作为兜底,处理未预期的异常并返回 500 状态码。这种分层处理机制保证了系统健壮性。开发者可以直接在业务代码中抛出 new HttpException(400, "Invalid Input"),框架会自动将其转换为 400 Bad Request 响应。
基于程序中某个输入、条件或结果的具体问题
当业务逻辑中需要根据数据库查询结果决定返回状态码时,例如用户不存在应返回 404,权限不足应返回 403,可以通过条件判断抛出不同的 HttpException 实例。这种做法避免了在控制器中编写大量的 if-else 状态码映射逻辑,使代码更清晰且易于维护。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











