Windows 下 Azure CLI / AWS CLI 偶发 10054 错误如何排查
结论:可以确定握手时连接被重置,但尚不能确定根因
ConnectionResetError(10054) / WinError 10054 表示连接被强制重置。堆栈停在 ssl.py 的 do_handshake,说明这次失败发生在 TLS 协商期间。
现有信息不足以判定是 IPv6、ISP、代理还是本机安全软件造成的。错误文本中的“remote host”也不能证明是 Azure 或 AWS 服务主动断开,连接路径上的代理、防火墙等设备同样可能导致重置。
部分执行成功只能说明相关请求在某些条件下能够完成,不能据此排除所有身份验证或服务端配置问题。一次 CLI 命令可能访问多个端点,需要先确认哪个请求失败。
1. 从调试日志中找到失败端点
给原来会失败的命令增加 --debug,分别保留成功和失败时的日志。例如,如果原来使用的是以下只读查询命令:
az group list --debug
aws sts get-caller-identity --debug
这两条命令仅作示例。不同命令访问的服务端点可能不同,请优先调试实际出现故障的命令。
重点比较:
- TLS 失败前正在连接的主机名和端口。
- 成功与失败是否发生在相同端点。
- 是否经过代理,是否出现重试或端点切换。
- 错误是否始终停在 TLS 握手阶段。
日志可能包含账户、资源、请求参数或身份验证信息,对外提供前应脱敏。对于创建、删除等操作,不要为收集日志反复执行。
2. 对同一个失败端点分别测试 IPv4 和 IPv6
IPv6 值得验证,但现有症状和标签都不能证明是 IPv6 故障。
在 PowerShell 中,将占位内容替换为日志中实际失败请求的主机名,不要包含 https:// 或路径:
$targetHost = '替换为实际失败端点的主机名'
Resolve-DnsName -Name $targetHost -Type A
Resolve-DnsName -Name $targetHost -Type AAAA
curl.exe -4 -v --connect-timeout 10 --output NUL "https://$targetHost/"
curl.exe -6 -v --connect-timeout 10 --output NUL "https://$targetHost/"
使用 curl.exe 可以避免部分 PowerShell 环境中 curl 别名带来的混淆。两种地址族应各测试数次,单次成功或失败无法解释间歇性问题。
| 测试结果 | 可以得到的判断 |
|---|---|
| IPv4 多次成功,IPv6 多次在握手阶段失败 | 优先调查 IPv6 路径、路由器及相关过滤规则 |
| IPv4 和 IPv6 都会失败 | 继续检查两者共用的代理、本机过滤或上游链路 |
| 两者均成功,CLI 仍失败 | 比较 CLI 的代理、实际端点和 TLS 行为 |
| 没有 AAAA 记录,或当前网络没有可用 IPv6 | 单独的 IPv6 测试失败不能证明存在异常 |
这里测试的是该主机的 HTTPS 连接。如果收到 401、403 或 404 等 HTTP 响应,说明这次请求已经完成 TLS 握手,但不代表 CLI 业务操作成功。
如果请求经过代理,-4 / -6 的结果可能主要反映到代理的连接,需要结合实际代理路径解释。curl.exe 与 CLI 的 TLS 实现也可能不同,因此这些结果只能缩小范围,不能单独确定根因。
3. 区分本机问题和网络路径问题
更换 Wi-Fi 后仍失败,不能自动排除网络原因。两个 Wi-Fi 可能共用路由器、出口或代理,而本机的 VPN、安全软件和网络过滤驱动也不会随 Wi-Fi 改变。
可以针对同一端点做以下对照:
- 同一台电脑连接家庭宽带和独立的手机热点。
- 同一网络下,用另一台电脑执行相同的连接测试。
- 检查是否启用了 VPN、系统代理、代理环境变量或 HTTPS 检查功能。
如果只有某台电脑在不同网络下持续失败,应优先检查该电脑的代理、过滤软件和网络驱动。如果多台电脑只在同一个出口失败,则优先调查路由器、出口策略或 ISP 路径。
对于受管理的安全软件,可以使用其诊断日志,或由管理员安排受控的对照测试。
4. 根据证据选择修复措施
如果证据集中指向 IPv6,检查路由器的 IPv6 配置、固件以及 ISP 的 IPv6 连通性。可以临时禁用 IPv6 做对照测试,记录结果后恢复;不要仅凭一次成功就长期禁用。
如果证据指向代理或 HTTPS 检查,核对 CLI 实际采用的代理配置,检查相关设备或软件的握手日志。出现明确的证书验证错误时,再针对证书信任链处理。
如果问题集中在某个 CLI,记录具体版本、失败端点和复现条件,比较其运行环境与连接行为,再判断是否需要升级、修复安装或提交问题报告。现有材料没有具体版本,无法认定某个版本已修复该问题。
如果问题只在特定出口出现,整理失败时间、目标主机、地址族及多设备测试结果,供网络管理员或 ISP 排查。必要时通过抓包进一步观察连接重置发生的位置。
注意事项
不要把关闭证书校验作为修复方法。它会削弱 TLS 安全性,也不能解决一般的连接重置问题。
重试可以暂时绕过部分瞬时故障,但不能证明问题已经解决。对于有副作用的命令,尤其应先确认请求是否已执行,再决定是否重试。
备注:内容仅供参考。
