Resilience4j实现数据库连接异常优雅降级需配置CircuitBreaker的recordExceptions（如SQLException）触发熔断，并用Decorators链式组合circuitBreaker与fallback；fallback在熔断开启或指定异常发生时执行，返回缓存/默认值，且自身需加超时防护。
Java 中实现数据库连接异常的优雅降级，核心是“不崩溃、有兜底、可感知”：当主数据源不可用时，自动切换到备用策略（如缓存、静态数据、本地文件或只读降级），同时记录日志并通知监控，避免雪崩或用户看到白屏/500。
1. 使用 Hystrix 或 Resilience4j 做熔断与降级
这是最成熟的方案。以 Resilience4j 为例（轻量、无依赖、函数式）：
- 定义一个 DatabaseService，所有 DB 操作封装在其方法中（如
findUserById(long id)） - 用
CircuitBreaker包裹该方法调用，配置失败阈值（如 5 次失败触发熔断）、等待时长（如 60 秒） - 熔断开启后，自动执行 fallback 方法：例如从 Redis 读缓存、返回默认用户对象、或查本地 JSON 文件
- 注意 fallback 方法必须签名一致、不能抛异常（否则会绕过降级）
2. 多数据源 + 动态路由 + 故障感知
适用于已有主从或双写架构的场景：
- 配置两个 DataSource（primary 和 backup），通过
AbstractRoutingDataSource动态选择 - 在路由逻辑中加入健康检查：每次获取连接前，先尝试用极短超时（如 200ms）ping 主库；失败则切 backup
- 用内存标志位（如
AtomicBoolean primaryHealthy）+ 定时任务做后台探活，恢复后平滑切回主库 - 避免每次请求都探测，可用指数退避重试机制减少抖动
3. 查询层统一包装：模板方法 + 可插拔降级策略
适合自研 ORM 或 MyBatis 场景，不引入第三方框架时也能控制：
立即学习“Java免费学习笔记（深入）”；
- 定义通用查询模板：
<T> T executeWithFallback(Supplier<T> dbOp, Supplier<T> fallback, Consumer<Exception> onError) - 内部捕获
SQLException、CannotGetJdbcConnectionException等典型连接异常 - 对不同业务指定不同 fallback：用户中心可返回缓存用户；订单查询可返回“服务暂不可用，请稍后再试”的结构化提示
- 关键点：区分异常类型——连接超时可降级，SQL 语法错误则不应降级，需原样报错
4. 日志、监控与人工干预通道
降级不是终点，而是可观测性的起点：
- 每次触发降级，必须打 ERROR 级别日志，含 traceId、DB 地址、异常堆栈、降级策略名
- 上报指标到 Prometheus：如
db_fallback_count{type="user_cache",reason="connect_timeout"} - 配置企业微信/钉钉告警，当 1 分钟内降级超 10 次，立即通知 DBA 和后端负责人
- 提供管理端开关：运维可通过 /actuator/db-fallback-toggle 接口临时关闭某服务的自动降级，便于紧急排查
不复杂但容易忽略的是：降级逻辑本身也要做超时和异常防护，避免 fallback 方法因 Redis 也挂了而卡住主线程。建议 fallback 内部加 100~300ms 超时，并设默认返回值兜底。
