从分钟到秒级 —— Amazon Advanced JDBC Wrapper 插件最佳实践
内容提要
AWS Advanced JDBC Wrapper通过bg、failover2、efm2插件，将数据库切换中断从分钟级降至秒级。实测蓝绿切换中断约1-4.3秒，Failover约7-15秒。关键配置包括设置connectTimeout为1000ms、按场景裁剪插件链、谨慎调整efm2参数。支持Aurora MySQL/PostgreSQL及RDS，需注意版本和权限要求。
延伸解读
客户端连接行为常被忽视
文章指出，数据库切换中断的放大主因往往不在实例本身，而在客户端的连接行为。DNS缓存、连接池持有失效连接、TCP握手挂起等三重打击，可能让中断从秒级恶化到数十秒。这提醒读者，优化高可用不能只盯着数据库，客户端驱动和连接池配置同样关键。
插件链按场景裁剪
不同场景需要不同的插件组合。蓝绿切换场景建议移除auroraConnectionTracker，避免其逐个断开连接拉长中断；故障转移场景则必须保留failover2，否则仅靠bg插件会导致应用连到只读节点，中断可能从约8秒升至约68秒。生产环境推荐组合为failover2、efm2、bg。
超时参数需区分对待
connectTimeout（驱动层TCP连接超时）宜短，设为1000ms可避免连到旧IP时握手挂起约30秒；而HikariCP的connectionTimeout（借连接等待超时）宜稍长，让业务线程熬过切换窗口。两者目标相反，一短一长，配置时需明确区分，不可混淆。
efm2参数是双刃剑
调小efm2检测参数能缩短中断，但会显著增加误触发风险。实测将检测时间从6秒压到3秒，纯重启中断缩短约2秒，但自动Failover误触发概率从22%升至50%。生产环境建议以稳定为先，使用默认值，避免因检测过快导致多次中断。
Q&A
AWS Advanced JDBC Wrapper 是什么？它如何帮助减少数据库切换中断？
AWS Advanced JDBC Wrapper 是一个开源的 JDBC 驱动包装器，它包裹在现有 JDBC 驱动之外，通过插件机制扩展功能，使 Java 应用能主动感知数据库拓扑变化并提前调度连接，从而将数据库切换中断从分钟级降至秒级。
bg、failover2、efm2 这三个插件分别有什么作用？
bg 插件用于蓝绿部署的快速感知，通过监控切换状态、预收集端点 IP、暂停对蓝节点的调用等机制缩短切换中断；failover2 插件用于故障转移的快速感知，通过集中式拓扑监控和并行探测快速找到新 Writer；efm2 插件用于节点健康监控，通过定期探针主动检测节点故障，使查询快速失败。
使用 AWS Advanced JDBC Wrapper 时，为什么必须设置驱动层的 connectTimeout？推荐值是多少？
设置驱动层的 connectTimeout 可以避免重连到尚未就绪的旧 IP 时 TCP 握手挂起约 30 秒，从而避免中断被拉长。推荐设置为 1000ms（1秒），这样单次连接失败可快速放弃并重试，将中断稳定在数秒区间。
在蓝绿切换和故障转移场景下，AWS Advanced JDBC Wrapper 分别能达到多少秒的中断时间？
在约 3000 TPS 负载下，蓝绿切换中断约 2.7-4.3 秒；Writer 重启中断约 5.5-7.6 秒；Failover 中断约 7-15 秒（中位数约 10 秒）。低负载下蓝绿切换中断可低至约 1 秒。
AWS Advanced JDBC Wrapper 的 bg 插件支持哪些数据库引擎和版本？
bg 插件支持 Aurora MySQL 3.07 及以上、Aurora PostgreSQL 17.5、16.9、15.13、14.18、13.21 及以上，以及 RDS MySQL（无版本限制）和 RDS PostgreSQL（需 rds_tools v1.7 及以上并手动执行 CREATE EXTENSION rds_tools;）。不支持 RDS Multi-AZ DB Cluster 和 Aurora Global Database。
使用 AWS Advanced JDBC Wrapper 时，非管理员数据库用户需要做什么额外配置？
非管理员数据库用户需要额外授权，否则无法读取蓝绿元数据表，bg 插件无法正常工作。以 MySQL 为例，需要执行：GRANT SELECT ON mysql.rds_topology TO 'your_user'@'%'; FLUSH PRIVILEGES;
AWS Advanced JDBC Wrapper 的配置助手 skill 是什么？如何使用？
配置助手 skill 是官方仓库提供的一个 Markdown 文件（JDBC-WRAPPER-CONFIGURATION-ASSISTANT.md），包含所有插件、参数、默认值、兼容性约束等信息。可以加载到 AI 编程工具（如 Kiro、Cursor、ChatGPT）中，用于生成初始配置、审查现有配置或定位配置问题。
