自定义全局异常处理需要创建继承自 runtimeexception 的异常类，并在控制器中抛出该异常。spring boot 默认会自动捕获此类运行时异常并返回 http 500 状态码。若需自定义响应格式或状态码，可结合 @controlleradvice 和 @exceptionhandler 注解实现统一拦截。

如何定义一个携带错误码和消息的业务异常类

直接回答：创建一个继承自 RuntimeException 的类，添加 errorCode 和 message 字段，并提供构造函数即可。

Spring Boot Actuator Analyzer

分析Spring Boot Actuator端点的安全性、健康检查、指标暴露及生产配置——审计信息、健康状态和自定义端点。

下载

public class BusinessException extends RuntimeException {
    private final String errorCode;

    public BusinessException(String errorCode, String message) {
        super(message);
        this.errorCode = errorCode;
    }

    public String getErrorCode() {
        return errorCode;
    }
}

如何在 Controller 中抛出并使用该异常

直接回答：在 Service 或 Controller 方法中使用 throw new BusinessException(...) 语句抛出异常，调用方无需显式捕获，由全局处理器接管。

@RestController
public class UserController {
    @GetMapping("/user/{id}")
    public User getUser(@PathVariable Long id) {
        if (id == null || id <= 0) {
            throw new BusinessException("USER_NOT_FOUND", "User not found with id: " + id);
        }
        return new User(id, "John");
    }
}

全局异常处理器如何捕获并返回 JSON 响应

直接回答：使用 @RestControllerAdvice 类配合 @ExceptionHandler(BusinessException.class) 方法，返回包含错误码、消息和状态的 JSON 对象。