面试必考：RuntimeException如何应对

当用户输入不符合预期时，例如长度、类型不正确

当出现数据库操作逻辑错误时，例如SQL写错无法执行

当出现业务逻辑错误时

当系统内部状态不一致时

当出现无法通过外部干预解决的问题时

当需要立即终止当前操作并修复代码时

当出现系统内部bug时

当出现设计缺陷时

当需要立即修复代码而不是处理异常时

当对象未初始化时，应使用子类 NullPointerException

当出现算术错误时，例如除0，应使用子类 ArithmeticException

当出现数组索引越界时，应使用子类 IndexOutOfBoundsException

当出现类型转换错误时，应使用子类 ClassCastException

当出现并发修改异常时，应使用子类 ConcurrentModificationException

当出现数据存储不一致时，应使用子类 ArrayStoreException

当出现空指针时，应使用子类 NullPointerException

当出现参数错误时，应使用子类 IllegalArgumentException

当需要返回错误码给前端时

当需要处理网络超时时

当需要处理数据库事务回滚时

当数据库连接失败时，应使用子类 SQLException

当文件系统操作失败时，应使用子类 IOException

当网络通信失败时，应使用子类 OException

当配置文件不存在时，应使用子类 FileNotFoundException

/**
 * 自定义异常类
 */
public class BusinessException extends RuntimeException {
    private final String code;
    private final String traceId;

    public BusinessException(String code, String message) {
        super(message);
        this.code = code;
        this.traceId = java.util.UUID.randomUUID().toString().replace("-", "");
    }
}


@RestControllerAdvice
@Slf4j
public class GlobalExceptionHandler {

    /**
     * 处理自定义业务异常
     * HTTP 400 (Bad Request)
     */
    @ExceptionHandler(value = BusinessException.class)
    public ResponseEntity<ApiResponse<Void>> handleBusinessException(BusinessException e) {
        log.warn("业务异常: code={}, message={}, traceId={}", e.getCode(), e.getMessage(), e.getTraceId());
        ApiResponse<Void> response = ApiResponse.fail(e.getCode(), e.getMessage());
        return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(response);
    }

    /**
     * 处理所有未预期的系统异常 (如: NullPointerException, RuntimeException)
     * 对前端返回通用的"系统繁忙"信息，避免暴露敏感信息
     * 记录详细错误日志用于排查
     * 返回 HTTP 500
     */
    @ExceptionHandler(Exception.class)
    public ResponseEntity<ApiResponse<Void>> handleUnexpectedException(Exception e) {
        String traceId = java.util.UUID.randomUUID().toString().replace("-", "");
        log.error("系统内部异常 [TraceID={}]: {}", traceId, e.getMessage(), e);

        ApiResponse<Void> response = ApiResponse.fail("SYSTEM_ERROR", "系统繁忙，请稍后重试");
        response.setTraceId(traceId);

        return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(response);
    }
}