程序报错但浏览器能打开：UA、Header、TLS 和 HTTP 客户端库的代理实现差异
程序使用代理 IP 报错但浏览器正常？对比请求头、TLS、代理加载方式和客户端实现，并用 curl 复现 407、403、429 或超时，定位程序接入差异。
浏览器能打开而程序报错，通常不是代理 IP 本身失效。更常见的原因是程序没有真正使用代理，或者程序发送的请求与浏览器不同。访问 HTTPS 网站时，客户端库还需要正确建立代理通道并完成 TLS 校验。排查时应先使用同一 URL 和同一代理做最小对照。
先确认程序确实加载了代理
记录程序实际使用的代理主机、端口和协议，并先请求出口检测页。出口 IP 没有变化时，优先查环境变量、代理参数格式、连接池和客户端库配置，不要先修改 UA。
同时检查 HTTP_PROXY、HTTPS_PROXY 等环境变量是否覆盖代码配置。修改代理后若连接池仍复用旧连接，应重新创建客户端或会话再测试。
浏览器和程序请求要对比哪些字段？
使用同一 URL、同一时间和同一代理，逐项对比请求方法、UA、Header、Cookie、重定向和响应体。浏览器能打开，只能说明浏览器这组请求成功，不代表程序发送了等价请求。
超时、407、TLS、403 和 429 分别说明什么？
| 错误表现 | 优先检查 | 说明 |
|---|---|---|
| 连接超时 | 代理参数、端口、网络 | 请求可能未走代理 |
| 407 | 用户名、密码、认证方式 | 入口已连接但认证失败 |
| TLS 或 HTTPS 握手错误 | 代理通道、TLS 校验、客户端实现 | 查客户端库如何处理 HTTPS 连接 |
| 403/429 | 请求特征和目标站规则 | 不应直接判断代理失效 |
访问 HTTPS 网站时，HTTP 代理通常会先通过 CONNECT 建立一条代理通道，再进行 TLS 校验并建立安全连接。客户端不支持这种方式、代理 URL 格式错误或 TLS 配置不正确，都可能导致连接失败。
目标网址以 https:// 开头，不代表代理入口必须选择 HTTPS。代理协议仍应按照服务商提供的 HTTP、HTTPS 或 SOCKS5 参数填写。出现 CONNECT 或 TLS 错误时，应检查客户端库文档和最小示例，不要把 TLS 配置填进代理账号或密码字段。
浏览器还会自动管理 Cookie、重定向和部分会话状态，程序则可能默认不跟随重定向或不保存 Cookie。对比时应把这些行为逐项记录，不要只看 UA 是否一致。
程序使用代理报错时怎么做最小复现？
1. 请求出口检测页，确认程序的出口 IP 已变化。
2. 请求一个普通 HTTPS 页面，确认 CONNECT、TLS 校验和重定向正常。
3. 再请求目标网站，记录状态码、异常类型和响应体摘要。
4. 用 curl 或第二个客户端重复同样步骤，只替换客户端实现，不同时更换代理 IP。
出口检测失败，回查代理加载和环境变量；普通 HTTPS 成功但目标网站失败，再对比 UA、Header、Cookie、请求频率和目标站规则。
curl 能否复现程序的代理错误？
可以用 curl 或另一种 HTTP 客户端库发送同一请求。下面示例使用独立参数传递凭据，避免把真实账号密码写进文章或代理 URL；请在本地替换占位符：
```bash
curl.exe -v --connect-timeout 10 \
--proxy "http://PROXY_HOST:PROXY_PORT" \
--proxy-user "PROXY_USERNAME:PROXY_PASSWORD" \
"https://api.ipify.org?format=json"
```
对照时保持代理参数、目标 URL、请求方法和测试时间一致，只替换客户端实现。根据 curl 的返回结果继续排查：
| 测试结果 | 说明 | 下一步 |
|---|---|---|
返回 200，出口 IP 已变化 | curl 已经通过代理发送请求 | 对比原程序的请求和代理配置 |
返回 407 Proxy Authentication Required | 已连接代理入口，但认证失败 | 检查用户名、密码和认证方式 |
| 连接超时、拒绝连接或无法解析主机 | 尚未完成代理连接 | 检查主机、端口和网络 |
| 出现 CONNECT 或 TLS 错误 | 客户端建立 HTTPS 连接失败 | 检查代理 URL、CONNECT 支持和 TLS 配置 |
不要为了通过测试而直接关闭 TLS 校验。命令输出只保留状态码、错误类型和出口 IP，避免记录真实凭据。
curl 成功但原程序失败，应该检查什么？
第二个客户端成功，说明代理入口和基础参数大概率可用。代理加载和连接复用先按前文方法检查，再对比重定向、Cookie 和 TLS 校验方式。
curl 和原程序都失败，应该回查哪些接入参数？
两个客户端都失败时，先不要修改 UA 或 Header。依次核对代理主机、端口、协议和认证，再请求出口检测页，判断问题发生在 TCP 连接、407 认证、TLS 握手还是目标网站响应阶段。
如果不确定代理字段应该怎样填写，可对照代理设置帮助页。
FAQ
UA 一样，为什么程序仍然失败？
UA 只是请求头的一部分。Cookie、Header、TLS 握手、重定向和连接复用也可能不同。
浏览器成功能证明代理可用吗？
只能证明浏览器这次请求成功。程序仍需用同一代理请求出口检测页和目标 URL 做对照。
TLS 错误要不要马上换 IP？
不要。先确认客户端库是否支持当前 HTTPS 代理方式、CONNECT 和 TLS 校验；参数正确后再判断目标站因素。
什么时候适合更换代理 IP？
当多个客户端都能建立代理连接，但同一目标站持续返回异常，才考虑更换同地区代理 IP；单个程序失败应先查代码和库配置。
程序报错但浏览器正常时，应该按什么顺序排查？
程序报错但浏览器能打开时，排查顺序是：确认代理加载 → 对比请求参数 → 区分连接、认证、TLS 和 HTTP 错误 → 用第二个客户端复测。这样能避免把程序实现问题误判成代理 IP 问题。