合理设置超时与重试机制可提升Python调用外部接口的健壮性：连接超时设1~3秒、读取超时3~15秒（不超过30秒）；仅对网络错误及502/503/504等临时错误重试2~3次，采用指数退避并记录日志；建议结合熔断与响应校验实现高可用。
Python调用外部接口时，网络不稳定、服务暂时不可用或响应延迟高是常见问题。合理设置超时与重试机制，能显著提升程序健壮性，避免卡死、异常中断或重复提交。
超时设置：分阶段控制，避免无限等待
HTTP请求超时应明确区分连接超时（connect timeout）和读取超时（read timeout）。连接超时指建立TCP连接的最长时间；读取超时指从服务器接收响应数据的等待上限。两者通常不相等，建议分别指定：
- 连接超时设为1~3秒（短时间即可判断目标是否可达）
- 读取超时视业务而定，一般3~15秒；若接口本身较慢（如报表生成），可适当放宽，但不宜超过30秒
- requests库中统一传入timeout=(3, 10)，即（连接超时, 读取超时）
- 避免只设单个数值（如timeout=10），否则可能在连接阶段就耗尽全部时间，无法进入读取环节
重试策略：有节制地重试，防止雪崩
不是所有失败都适合重试。需区分错误类型：网络类（ConnectionError、Timeout）、服务端临时错误（502/503/504）可重试；客户端错误（400/401/404）或明确失败（如返回{“code”:40001}）不应重试。
- 推荐使用urllib3.util.retry.Retry或tenacity库实现可控重试
- 重试次数建议2~3次，最多不超过5次；首次失败后延迟1秒再试，后续采用指数退避（如1s → 2s → 4s）
- 对POST/PUT等非幂等请求，务必确认接口支持重试（例如带唯一请求ID、服务端去重），否则可能造成重复操作
- 记录每次重试日志（含状态码、耗时、重试次数），便于排查是否陷入无效循环
组合实践：超时+重试+熔断初阶建议
生产环境建议三者配合使用。简单示例（基于requests + urllib3 Retry）：
立即学习“Python免费学习笔记（深入）”；
- 创建Session，挂载Retry对象，配置只对502/503/504及连接异常重试
- 每个请求显式指定timeout=(3, 10)
- 对高频调用接口，可在上层加简单计数熔断（如1分钟内连续5次超时，暂停调用30秒）
- 关键业务调用后校验响应结构（如检查"code"字段是否为0），失败则按业务逻辑兜底，不依赖重试
