Java 项目异常设计：从滥用控制流到防御性编程的规范落地

// 反模式：滥用异常控制业务流程
try {
    Object data = queue.pop();
    process(data);
} catch (NullPointerException e) {
    // 队列为空时执行其他逻辑
    doSomethingElse();
}

public enum ErrorCode {
    SUCCESS(200, "操作成功"),
    // 客户端错误：400开头
    INVALID_PARAM(4001, "请求参数不合法"),
    UNAUTHORIZED(4002, "未授权的访问"),
    // 具体业务模块错误（例如消息队列核心模块）
    TOPIC_NOT_FOUND(5011, "指定的消息主题不存在"),
    BROKER_DISCONNECT(5012, "与 Broker 节点的连接已断开"),
    QUEUE_CAPACITY_EXCEEDED(5013, "消息队列容量已达上限"),
    // 系统级兜底错误：500开头
    SYSTEM_ERROR(5000, "系统内部繁忙，请稍后再试");
    private final int code;
    private final String message;
    ErrorCode(int code, String message) {
        this.code = code;
        this.message = message;
    }
    // getter 省略...
}

public class SystemException extends RuntimeException {
    private final ErrorCode errorCode;
    public SystemException(ErrorCode errorCode) {
        super(errorCode.getMessage());
        this.errorCode = errorCode;
    }
    public SystemException(ErrorCode errorCode, Throwable cause) {
        super(errorCode.getMessage(), cause);
        this.errorCode = errorCode;
    }
    public ErrorCode getErrorCode() {
        return errorCode;
    }
}

@RestControllerAdvice
public class GlobalExceptionHandler {
    private static final Logger log = LoggerFactory.getLogger(GlobalExceptionHandler.class);
    /**
     * 拦截所有已知的业务异常
     */
    @ExceptionHandler(SystemException.class)
    public Result<Void> handleSystemException(SystemException e) {
        // 业务异常属于预期内的非正常状态，通常记录 WARN 级别日志即可
        log.warn("业务中断, ErrorCode: {}, Message: {}", e.getErrorCode().getCode(), e.getMessage());
        return Result.fail(e.getErrorCode().getCode(), e.getErrorCode().getMessage());
    }
    /**
     * 拦截参数校验异常（通常由 @Valid 触发）
     */
    @ExceptionHandler(MethodArgumentNotValidException.class)
    public Result<Void> handleValidationException(MethodArgumentNotValidException e) {
        String msg = e.getBindingResult().getAllErrors().get(0).getDefaultMessage();
        log.warn("参数校验失败: {}", msg);
        return Result.fail(ErrorCode.INVALID_PARAM.getCode(), msg);
    }
    /**
     * 兜底拦截：处理所有未知的运行时异常 (如 NullPointerException, IndexOutOfBoundsException)
     */
    @ExceptionHandler(Exception.class)
    public Result<Void> handleUnknownException(Exception e) {
        // 未知异常意味着代码存在严谨性 Bug，必须记录 ERROR 级别日志并触发告警
        log.error("发生未捕获的系统异常", e);
        return Result.fail(ErrorCode.SYSTEM_ERROR.getCode(), ErrorCode.SYSTEM_ERROR.getMessage());
    }
}