一、全局异常处理架构图（Mermaid 可渲染）
二、分层架构说明
1. 客户端层
- 输入：HTTP请求（REST/GraphQL/RPC）
- 关键点：
- 通过Content-Type头区分异常响应格式（JSON/XML）
- 自动携带X-Request-ID用于链路追踪
2. Spring容器层
| 组件 | 职责 | 配置示例 |
|---|---|---|
| DispatcherServlet | 异常捕获入口 | spring.mvc.throw-exception-if-no-handler-found=true |
| ControllerAdvice | 全局异常路由 | @Order(Ordered.HIGHEST_PRECEDENCE) |
| HandlerInterceptor | 预处理/后处理 | 在preHandle中设置请求上下文 |
3. 异常处理器层
// 处理器通用接口设计
public interface ExceptionHandler<T extends Exception> {
ErrorResponse handle(T ex, HttpRequest request);
}
// 业务异常处理器实现示例
@Component
public class BusinessExceptionHandler implements ExceptionHandler<BusinessException> {
@Override
public ErrorResponse handle(BusinessException ex, HttpRequest request) {
// 记录业务上下文
Metric.counter("business.error", "type", ex.getType()).increment();
return ErrorResponse.of(ErrorCode.BUSINESS_ERROR, ex.getMessage());
}
}
4. 处理流程层
| 步骤 | 技术实现 | 性能优化要点 |
|---|---|---|
| 业务日志记录 | 异步日志（Log4j2 AsyncLogger） | 使用RingBuffer避免阻塞主线程 |
| 字段级错误返回 | BindingResult解析 | 只处理第一个错误字段（O(1)复杂度） |
| 数据库自动重试 | @Retryable注解 | 指数退避策略：backoff = @Backoff(delay=1000, multiplier=2) |
| 熔断触发 | Resilience4j CircuitBreaker | 滑动窗口统计：slidingWindowSize=100 |
| 现场快照保存 | Java Flight Recorder（JFR） | 限制Dump时间：maxDumpDuration=5s |
5. 响应组装层
// 统一响应构建器
public class ErrorResponseBuilder {
public static ErrorResponse build(ErrorCode code, Exception ex) {
return ErrorResponse.builder()
.code(code.getCode())
.message(code.getMessage())
.traceId(MDC.get("traceId"))
.timestamp(Instant.now())
.path(getCurrentRequestPath())
.build();
}
}
三、关键设计图补充
1. 类关系图（Mermaid）
2. 序列图（异常处理流程）
四、生产级配置模板
1. 异常类型映射（YAML）
spring:
mvc:
throw-exception-if-no-handler-found: true
exception-mappings:
com.example.BusinessException: 400
javax.validation.ValidationException: 422
java.sql.SQLException: 503
2. 日志配置（Logback）
<!-- 异步异常日志 -->
<appender name="ASYNC_ERROR" class="ch.qos.logback.classic.AsyncAppender">
<discardingThreshold>0</discardingThreshold>
<queueSize>1000</queueSize>
<appender-ref ref="ERROR_FILE"/>
</appender>
<!-- 结构化日志 -->
<encoder class="net.logstash.logback.encoder.LogstashEncoder">
<customFields>{"service":"${spring.application.name}"}</customFields>
</encoder>
3. 告警规则（Prometheus）
groups:
- name: exception-alerts
rules:
- alert: DatabaseErrorRateHigh
expr: rate(database_exception_total[5m]) > 10
labels:
severity: critical
annotations:
summary: "数据库异常激增 ({
{ $value }}次/分钟)"
五、性能优化对照表
| 优化措施 | 性能影响（P99延迟） | 适用场景 |
|---|---|---|
| 禁用非关键异常堆栈 | ↓ 15ms | 高频业务异常（如参数校验） |
| 异步日志记录 | ↓ 20ms | 所有异常类型 |
| 熔断器快速失败 | ↓ 50ms | 第三方服务调用 |
| 响应缓存 | ↓ 5ms | 重复异常（如相同SQL错误） |
六、如何验证图表可查看？
- 直接复制Mermaid代码到支持渲染的编辑器（如VS Code插件、GitLab/GitHub Wiki）
- 在线渲染工具：
- Mermaid Live Editor
- Draw.io（导入Mermaid）
通过此设计可实现：
✅ 可视化架构：所有图表均使用标准Mermaid语法
✅ 分层解耦：各模块职责边界清晰
✅ 生产就绪：含完整配置模板和性能数据
✅ 协作友好：工程师可直接复制代码/配置使用
