spring boot 全局异常处理捕获策略选择异常的核心在于利用 @controlleradvice 配合 @exceptionhandler 注解,将特定业务异常与处理方法绑定。通过定义一个继承自 runtimeexception 的自定义异常类(如 strategychoiceexception),并在控制器中抛出该异常,全局处理器即可拦截并返回统一的 json 响应。这种做法能确保前端接收到明确的错误码和提示信息,同时保持控制器的整洁。

@ControllerAdvice 如何拦截自定义异常
要拦截自定义的策略选择异常,需要在配置类中使用 @RestControllerAdvice 或 @ControllerAdvice 注解声明一个全局异常处理器。在该类中,定义一个方法并使用 @ExceptionHandler(StrategyChoiceException.class) 指定要处理的异常类型。当控制器抛出该异常时,Spring MVC 会自动调用此方法。该方法应返回 ResponseEntity 对象,以便设置 HTTP 状态码和响应体。这样做的结果是,无论异常在哪个控制器层抛出,都会被统一捕获并格式化为标准的 API 响应结构。

import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(StrategyChoiceException.class)
public ResponseEntity<errorresponse> handleStrategyChoiceException(StrategyChoiceException ex) {
ErrorResponse error = new ErrorResponse(ex.getCode(), ex.getMessage());
return ResponseEntity.status(ex.getHttpStatus()).body(error);
}
}</errorresponse>
上述代码展示了全局异常处理器的基本实现。其中 StrategyChoiceException 是自定义异常,包含错误码、消息和 HTTP 状态码。 ErrorResponse 是用于封装返回数据的 DTO。当发生策略选择错误时,系统会返回对应的 JSON 数据,例如 {"code": "STRATEGY_INVALID", "message": "无效的策略选择"}。
如何在控制器中抛出并处理策略选择异常
在具体的业务逻辑中,当检测到策略选择无效或冲突时,应直接抛出 StrategyChoiceException。这通常发生在验证用户输入或检查业务规则的阶段。通过在控制器方法中显式抛出异常,可以中断当前执行流程并触发全局异常处理器。这种方式比在控制器中手动判断并返回错误响应更清晰,符合单一职责原则。结果是将错误处理逻辑从业务代码中解耦,使控制器专注于核心业务逻辑。

import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
@RequestMapping("/api/strategy")
public class StrategyController {
private final StrategyService strategyService;
public StrategyController(StrategyService strategyService) {
this.strategyService = strategyService;
}
@PostMapping("/select")
public ResponseEntity<string> selectStrategy(@RequestBody StrategyRequest request) {
try {
String result = strategyService.processStrategy(request);
return ResponseEntity.ok(result);
} catch (StrategyChoiceException e) {
throw e; // 重新抛出以触发全局异常处理
}
}
}</string>
在控制器中,我们使用 try-catch 块捕获服务层抛出的 StrategyChoiceException,然后重新抛出。这样做的目的是确保异常能够被全局处理器正确识别。如果不在这里重新抛出,异常可能会被吞掉或导致不同的处理路径。实际运行中,当传入无效的 StrategyRequest 时,服务层会抛出异常,最终由全局处理器返回 400 Bad Request 状态码及错误信息。
基于 StrategyRequest 输入校验失败的具体问题
当 StrategyRequest 中的策略 ID 不存在或已被禁用时,全局异常处理如何具体响应?在这种情况下,服务层会抛出带有特定错误码的 StrategyChoiceException。全局处理器捕获后,会根据异常中设置的 HTTP 状态码(如 404 Not Found 或 400 Bad Request)返回相应的 JSON 响应。这种机制确保了前端能够根据状态码和错误消息做出正确的 UI 反馈,例如显示“策略不存在”或“策略已禁用”。通过这种方式,输入校验失败的问题得到了统一且清晰的解决。











