Windows
macOS
Android
iOS
刚接入位于新加坡、东京或法兰克福的 PostgreSQL、MySQL 数据库时，最常见的问题不是账号错误，而是跨地域链路中的连接建立过慢。做好海外数据库连接超时重试设计，需要同时考虑网络距离、数据库负载、连接池容量和业务是否允许重复执行。下面用六项建议拆解一套适合新手落地的方法。
一、先分清连接超时和查询超时
连接超时发生在建立 TCP 连接、完成加密协商或取得数据库会话之前；查询超时则是已经连上数据库，但 SQL 执行或返回结果过慢。两者不能使用同一套重试规则。
- 连接超时：可能与跨境链路抖动、路由变化、防火墙规则或数据库连接数达到上限有关，通常可以有限重试。
- 查询超时：可能是锁等待、索引缺失、慢查询或数据库负载过高，盲目重试会增加数据库压力。
在海外数据库连接超时重试设计中，建议分别记录连接耗时、认证耗时和 SQL 执行耗时。这样才能判断问题位于网络、数据库入口还是业务查询本身。
二、为每个阶段设置独立超时
不要只设置一个很大的总超时。可以把总请求时间拆成连接超时、读超时和业务截止时间。跨地域访问时，连接超时通常可从约 3 至 10 秒起步，再依据线路稳定性调整；读超时则应结合 SQL 的正常执行时长确定。
推荐的设置思路
- 先定义业务能够接受的总等待时间，例如普通查询控制在约 10 至 30 秒内。
- 将其中一部分分配给建立连接，避免连接阶段耗尽全部预算。
- 为每次重试重新计算剩余时间，剩余预算不足时立即停止。
- 对报表、批处理等长任务使用异步队列，不要让前端请求无限等待。
如果一次操作的总预算只有 8 秒，却设置 3 次各 10 秒的连接等待，实际仍可能拖住线程几十秒，这种配置不属于可靠的海外数据库连接超时重试设计。
三、采用指数退避并加入随机抖动
连续快速重试会让大量应用实例同时再次访问数据库，形成“惊群”。更稳妥的方式是指数退避：第一次失败后等待较短时间，后续等待逐步增加，并加入少量随机抖动。
常见做法是将等待时间控制在约 200 毫秒至 2 秒的起步范围，最大退避可限制在几秒到十几秒，具体取决于总超时和业务类型。实时接口通常只允许 1 至 2 次重试；后台任务可以有更多次数，但仍应受到总时间限制。
随机抖动不需要精确到固定数值，重点是让不同实例不要在同一时刻发起下一次连接。指数退避适合应对短暂网络波动，但无法修复错误的地址、失效凭据或被拒绝的来源地址。
四、只对可恢复错误进行重试
重试前应先分类错误。连接被对端重置、临时网络不可达、短暂连接超时，通常具有一定可恢复性；用户名或密码错误、数据库不存在、证书校验失败、权限不足，则应立即失败并告警。
| 错误类型 | 建议动作 | 原因 |
|---|---|---|
| 连接建立超时 | 有限重试 | 可能是临时链路抖动 |
| 连接被重置 | 退避后重试 | 可能存在短时网络或服务端压力 |
| 认证失败 | 不重试 | 重复请求不能修复凭据 |
| SQL 锁等待超时 | 先分析 SQL 和事务 | 重试可能扩大锁竞争 |
这一步是海外数据库连接超时重试设计的边界控制。宁可快速暴露配置错误，也不要让应用通过反复尝试掩盖根因。
五、配合连接池、熔断和健康检查
连接池可以减少每次请求都重新建立数据库连接的成本，但连接池里的连接也可能因空闲过久、网络切换或服务端回收而失效。应用取出连接时，应验证连接可用性；发现连接失效后，销毁该连接并重新获取，而不是把坏连接反复放回池中。
当连续失败达到阈值时，可暂时打开熔断，短时间内快速失败，等待探测请求成功后再恢复。健康检查应尽量使用轻量操作，例如数据库支持的简单连接检测，不要用复杂业务查询充当探针。这样能避免数据库故障期间重试流量继续增长。
六、确认业务操作具备幂等性
连接超时并不一定表示数据库没有执行成功。比如插入订单时，应用已经发送请求，数据库完成提交，但响应在跨地域链路中丢失；此时再次插入可能产生重复数据。
因此，海外数据库连接超时重试设计必须配合幂等键、唯一约束或业务状态表。支付、订单、库存扣减等操作尤其要谨慎。查询通常更容易重试；写入操作则应先设计唯一业务编号，并在数据库层保证重复请求不会产生第二条有效记录。
落地时的检查清单
- 记录每次尝试的开始时间、结束时间、错误类别和目标数据库。
- 区分连接超时、查询超时、认证失败和数据库拒绝。
- 限制最大重试次数，同时限制总耗时。
- 采用指数退避和随机抖动，避免实例同时重连。
- 为写操作设置幂等键，并验证连接池是否清理失效连接。
- 监控成功率、重试次数、连接池占用和数据库端连接数。
常见问题
连接超时重试几次合适？
实时接口通常从 1 至 2 次开始，后台任务可适当增加，但必须受总时间预算限制，不能只看次数。
重试间隔是否越长越好？
不是。间隔过短会制造压力，过长又会影响用户体验，应根据业务截止时间和故障恢复特点设置。
连接池能否替代重试？
不能。连接池减少了正常连接开销，但无法解决网络中断、凭据错误或数据库不可用，仍需有针对性的失败处理。
所有 SQL 都能自动重试吗？
不能。只读查询相对安全；写入、扣库存和状态变更必须先确认幂等机制，否则可能产生重复执行。
总的来说，可靠的海外数据库连接超时重试设计应以“有限重试、快速识别、控制压力、保证幂等”为原则，而不是简单地增加重试次数。