Boto3 S3 upload_file偶发60秒连接超时问题排查咨询

关于ConnectTimeoutError的实际含义 #

这个异常不代表客户端发送PUT请求后未收到服务端响应。
从你贴的完整错误栈可以直接定位到异常根因：最底层的超时抛出点是sock.connect(sa)系统调用，也就是TCP三次握手阶段超时——此时客户端还没和S3服务端完成TCP连接建立，根本没有发送任何HTTP PUT请求内容，完全不存在"请求已发出、等待服务端响应"的场景。
你提到的"发了请求等不到响应"对应的是读超时（ReadTimeout），和当前的连接超时是完全独立的两类超时配置。你观察到的60秒卡顿就是boto3默认的连接超时等待时长：默认配置下，单次握手超时后boto3会自动走重试逻辑，换链路/端口重新建连，所以最终能上传成功；如果你手动把连接超时阈值调得过低，重试还没来得及触发就直接抛出异常，就会看到你贴的两类ConnectTimeoutError（botocore的异常是对urllib3原生异常的封装，本质是同一个问题）。
这类偶发TCP握手超时，常见诱因包括公网链路抖动、跨区域访问S3端点路由绕路、本地NAT网关端口耗尽、防火墙/安全组偶发拦截出站SYN包。

关于Boto3客户端初始化阶段的行为 #

执行boto3.client('s3')初始化客户端时，不会提前建立任何和S3服务端的网络连接，这个阶段仅做本地配置加载工作，和你遇到的超时问题没有关联：

• 从环境变量、本地凭证文件、云服务器实例元数据服务等来源加载并校验AWS访问凭证
• 加载指定区域的S3服务端点地址、API协议版本等配置
• 初始化HTTP连接池、默认重试策略、请求序列化/响应反序列化组件
  所有和S3服务端的实际网络连接，都是第一次发起API请求（也就是调用upload_file触发实际分片上传、PUT对象请求时）才会按需建立。

排查建议 #

• 优先确认你使用的S3端点和客户端配置的区域一致，不要跨区域访问S3，公网访问尽量使用对应区域的官方公网端点，有条件的话走VPC内网端点访问，减少公网链路抖动影响
• 如果是大文件上传、并发上传文件量较大，检查本地出口NAT网关的端口配额，短时间大量新建TCP连接很容易触发端口耗尽，导致握手失败
• 本地IDC环境访问S3的话，检查出口防火墙、上网行为管理设备是否有偶发拦截出站HTTPS请求SYN包的规则
• 不建议把连接超时设置得过短，公网场景下建议保留10~30秒的连接超时阈值，不要关闭boto3默认的重试机制。

内容的提问来源于stack exchange，提问作者mangotango