Postman 报错 Proxy Connection Failed 通常是因为代理地址配置错误、网络无法连通代理服务器或 SSL 证书验证失败。建议先检查 Settings 中的 Proxy 配置项,确认 host 和 port 无误,再验证网络连通性。
先说结论:该报错表明 Postman 无法通过配置的代理服务器建立连接,优先排查代理地址可达性和认证信息。
- 先确认:Postman 设置中的 Proxy Host 和 Port 是否与实际代理服务器一致。
- 先处理:关闭 SSL 证书验证或更换网络环境测试连通性。
- 再验证:通过 Postman Console 查看具体握手失败日志。
命令速用版
本问题主要涉及图形界面配置,无直接命令行修复方案,建议按以下路径快速检查:
- 打开 Postman,点击左上角 File 或齿轮图标进入 Settings。
- 选择 Proxy 标签页,检查 Use Custom Proxy Configuration 是否勾选。
- 若无需代理,取消勾选该选项并保存。
为什么会这样
Proxy Connection Failed 本质是 TCP 握手或 SSL 握手在代理环节中断。Postman 作为客户端,在发起请求前会尝试连接配置的代理服务器,若代理服务器无响应、拒绝连接或证书不信任,就会抛出此错误。
分步处理
按顺序执行以下操作,每步完成后尝试发送请求:
- 检查代理配置:进入 Settings > Proxy,确认 Proxy Type 是 http 或 https,Host 和 Port 字段无多余空格。
- 测试网络连通:在终端使用
curl -v http://www.example.com确认本机网络正常,排除本地断网可能。 - 关闭 SSL 验证:在 Settings > General 中,关闭 SSL certificate verification 选项,排除证书信任问题。
- 清除认证信息:若代理需要密码,确认 Proxy Authentication 中用户名密码正确,或暂时清空测试是否为认证导致。
怎么验证是否生效
打开 Postman Console(快捷键 Ctrl + Alt + C 或菜单 View > Show Postman Console),发送请求后观察日志。
- 若生效:Console 中显示 200 OK 或具体业务状态码,无 Proxy Error 字样。
- 若未生效:Console 中仍显示 ECONNREFUSED 或 Proxy Authentication Required。
常见坑
- 系统代理冲突:Postman 默认使用系统代理,若在 Settings 中又配置了自定义代理,可能产生冲突,建议统一配置源。
- 代理协议不匹配:配置了 HTTP 代理地址却选择了 HTTPS 协议类型,会导致握手失败。
- 内网环境限制:公司防火墙可能禁止直接连接外部代理服务器,需确认网络策略允许。
常见问题
关闭代理设置后仍然报错怎么办
检查系统环境变量是否保留了 HTTP_PROXY 或 HTTPS_PROXY,Postman 会读取这些变量。
如何查看详细的代理错误日志
必须打开 Postman Console 面板,普通响应窗口不显示底层连接错误详情。
代理需要域名解析怎么办
在 Proxy Host 中直接填写 IP 地址可避免 DNS 解析失败导致的连接问题。
参考来源
- Postman Learning Center, "Postman settings", https://learning.postman.com/docs/sending-requests/proxy-and-certificate-setup/