本文介绍在 Spring Boot 中利用 @RestControllerAdvice 实现基于请求头（如 sourceid）动态路由至不同异常响应格式的技巧，通过统一异常处理器内部分支逻辑，灵活适配多部门定制化的错误返回结构。
本文介绍在 spring boot 中利用 `@restcontrolleradvice` 实现基于请求头（如 `sourceid`）动态路由至不同异常响应格式的技巧，通过统一异常处理器内部分支逻辑，灵活适配多部门定制化的错误返回结构。
在微服务或企业级 API 开发中，常需为不同调用方（如多个业务部门）提供兼容其既有规范的错误响应格式——例如部门 A 要求 4xx 错误返回 { "code": "INVALID_PARAM", "message": "..." }，而部门 B 要求 { "errCode": 400, "errMsg": "..." }。虽然 Spring 的 @ExceptionHandler 不支持直接按请求头（如 sourceid）声明式绑定多个同类型异常处理器，但可通过一个通用处理器结合运行时 Header 解析实现精准路由。
核心思路是：定义一个 @RestControllerAdvice 类，在其 @ExceptionHandler 方法中注入 HttpServletRequest，读取 sourceid 头字段，并根据其值分发至对应格式化逻辑。示例如下：
@RestControllerAdvice
public class DepartmentAwareExceptionHandler {
@ExceptionHandler({IllegalArgumentException.class, ValidationException.class})
public ResponseEntity<object> handleClientError(
Exception ex, HttpServletRequest request) {
String sourceId = request.getHeader("sourceid");
HttpStatus status = HttpStatus.BAD_REQUEST;
// 根据 sourceid 动态构造响应体
Object responseBody;
if ("dept-a".equalsIgnoreCase(sourceId)) {
responseBody = Map.of(
"code", "VALIDATION_FAILED",
"message", ex.getMessage()
);
} else if ("dept-b".equalsIgnoreCase(sourceId)) {
responseBody = Map.of(
"errCode", status.value(),
"errMsg", ex.getMessage()
);
} else {
// 默认格式（可对接标准 RFC 7807）
responseBody = Problem.builder()
.withStatus(status)
.withDetail(ex.getMessage())
.build();
}
return ResponseEntity.status(status).body(responseBody);
}
}</object>
⚠️ 注意事项：
- 确保 sourceid 头部已由网关或前端可靠传递，建议在 @ExceptionHandler 中添加空值/非法值兜底处理（如记录告警并返回默认格式）；
- 若需复用大量格式化逻辑，可将各部门响应构建器抽象为策略接口（如 ErrorResponseBuilder），配合 Spring 的 @Qualifier 注入对应 Bean，提升可维护性；
- 避免在异常处理器中执行耗时操作（如远程调用、数据库查询），否则可能加剧故障影响面；
- 对于 @ResponseStatus 或 ResponseEntity 的状态码，仍应严格匹配实际 HTTP 状态语义（如 401/403/404/500 等），不可因格式差异而混淆语义。
综上，虽无法“声明式”注册多个同异常类型的处理器，但借助 HttpServletRequest 的上下文感知能力，完全可在单一入口内实现高内聚、低耦合的多租户异常响应治理，兼顾灵活性与可维护性。
