Java自定义异常最佳实践：带HttpCode的父异常类实现问题

这是个非常典型的业务异常场景，我在多个后端项目里都落地过类似的设计，核心是要兼顾异常的不可变性、业务语义清晰和与HTTP响应的无缝对接。下面是完整的最佳实践方案：

一、抽象父异常类的正确设计 #

首先，你的ParentException应该继承RuntimeException（而非直接继承Exception），这样业务代码无需强制捕获，只需要在全局异常处理器统一处理即可。另外，不建议给httpCode加setter方法——异常是一种“事件记录”，一旦创建就不应该被修改状态，可变的异常会带来线程安全问题和语义混乱，应该在构造时就确定httpCode。

完整的抽象父类代码如下：

import org.springframework.http.HttpStatus;

public abstract class ParentException extends RuntimeException {
    private final int httpCode; // 用final保证不可变性

    // 基础构造器：传入错误码和自定义消息
    protected ParentException(int httpCode, String message) {
        super(message);
        this.httpCode = httpCode;
    }

    // 支持传入异常原因（用于包装底层异常，比如DAO层的SQLException）
    protected ParentException(int httpCode, String message, Throwable cause) {
        super(message, cause);
        this.httpCode = httpCode;
    }

    // 仅传入错误码和原因（适用于不需要自定义消息的场景）
    protected ParentException(int httpCode, Throwable cause) {
        super(cause);
        this.httpCode = httpCode;
    }

    // 唯一的getter方法，无setter
    public int getHttpCode() {
        return httpCode;
    }
}

二、业务子类异常的实现 #

基于抽象父类，你可以为不同的HTTP错误场景创建具体的子类，这样业务代码中抛出异常时语义更明确，比如：

// 对应404 Not Found：资源不存在场景
public class ResourceNotFoundException extends ParentException {
    public ResourceNotFoundException(String message) {
        super(HttpStatus.NOT_FOUND.value(), message);
    }

    public ResourceNotFoundException(String message, Throwable cause) {
        super(HttpStatus.NOT_FOUND.value(), message, cause);
    }
}

// 对应400 Bad Request：参数错误、请求非法场景
public class BadRequestException extends ParentException {
    public BadRequestException(String message) {
        super(HttpStatus.BAD_REQUEST.value(), message);
    }
}

// 对应403 Forbidden：权限不足场景
public class ForbiddenException extends ParentException {
    public ForbiddenException(String message) {
        super(HttpStatus.FORBIDDEN.value(), message);
    }
}

三、全局异常处理器的配合（以Spring为例） #

为了让异常自动转换为标准HTTP响应，你需要在项目中添加全局异常处理器，比如Spring的@RestControllerAdvice：

import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;

@RestControllerAdvice
public class GlobalExceptionHandler {

    // 统一处理所有自定义业务异常
    @ExceptionHandler(ParentException.class)
    public ResponseEntity<ErrorResponse> handleBusinessException(ParentException ex) {
        ErrorResponse errorResponse = new ErrorResponse(ex.getHttpCode(), ex.getMessage());
        return ResponseEntity.status(ex.getHttpCode()).body(errorResponse);
    }

    // 兜底处理系统未知异常
    @ExceptionHandler(Exception.class)
    public ResponseEntity<ErrorResponse> handleGenericException(Exception ex) {
        ErrorResponse errorResponse = new ErrorResponse(500, "系统内部错误，请稍后重试");
        return ResponseEntity.status(500).body(errorResponse);
    }

    // 错误响应DTO，用于返回给前端的标准格式
    public static class ErrorResponse {
        private int code;
        private String message;

        public ErrorResponse(int code, String message) {
            this.code = code;
            this.message = message;
        }

        // getter方法
        public int getCode() { return code; }
        public String getMessage() { return message; }
    }
}

四、设计的核心优势 #

• 不可变性：httpCode用final修饰，构造时确定，避免后续修改带来的状态混乱
• 语义清晰：每个子类对应明确的业务/HTTP错误场景，业务代码抛出时一目了然
• 低侵入性：业务代码只需要抛出对应异常，无需关心HTTP响应的构建逻辑
• 扩展性强：新增业务异常场景只需要继承ParentException并指定错误码即可

内容的提问来源于stack exchange，提问作者Sannu