Python requests 使用 HTTP/SOCKS5 代理的常见错误

Python requests 使用代理时，最常见的问题不是目标站本身，而是代理 URL 写错、只配置了一个请求协议、SOCKS 依赖缺失、DNS 解析位置不符合预期，或没有分别设置连接与读取超时。本文按代理配置、依赖、DNS、超时和 TLS 逐项排查。

在 Requests 中同时配置 HTTP 和 HTTPS 代理

即使目标 URL 是 HTTPS，也经常通过 HTTP 代理建立 CONNECT 隧道。因此，代理地址是否写成 http:// 应以服务商交付的协议和端口为准，不要因为目标 URL 是 HTTPS 就擅自改成 https://。

```python
import requests

proxy_url = "http://USERNAME:PASSWORD@HOST:PORT"
proxies = {
"http": proxy_url,
"https": proxy_url,
}

response = requests.get(
"https://api.ipify.org?format=json",
proxies=proxies,
timeout=(10, 30),
)
response.raise_for_status()
print(response.json())
```

预期结果是返回的 ip 为代理出口 IP。如果仍显示本地公网 IP，先检查调用位置是否真的传入了 proxies，以及是否有 Session、环境变量或其他网络库覆盖当前设置。

账号或密码包含特殊字符时先编码

账号或密码里的 @、:、/、# 等字符会破坏 URL 结构，应先做 URL 编码。不要把真实密码打印到日志。

```python
from urllib.parse import quote

username = quote("USERNAME", safe="")
password = quote("PASSWORD", safe="")
proxy_url = f"http://{username}:{password}@HOST:PORT"
```

如果响应为 407，说明请求已经到达代理认证环节，但账号、密码、协议或认证方式不匹配。407 不是目标站返回的权限错误。

使用 SOCKS5 前先安装依赖并确认 DNS 解析位置

安装 SOCKS 支持依赖

requests 的 SOCKS 支持通常需要额外依赖：

```bash
python -m pip install "requests[socks]"
```

依赖必须安装在脚本实际运行的 Python 环境中；如果命令行和任务调度器使用的解释器不同，应分别确认版本和安装位置。

配置 socks5 与 socks5h

requests 需要在 http 和 https 两个键中分别配置代理，否则可能出现 HTTP 请求正常、HTTPS 请求未经过代理的情况。

配置示例：

```python
import requests

proxy_url = "socks5h://USERNAME:PASSWORD@HOST:PORT"
proxies = {
"http": proxy_url,
"https": proxy_url,
}

response = requests.get(
"https://api.ipify.org?format=json",
proxies=proxies,
timeout=(10, 30),
)
print(response.status_code, response.text)
```

先验证公网出口，再访问目标站；不要只根据目标站返回的 403、429 或验证码判断 SOCKS5 配置是否正确。

DNS 异常时如何判断解析位置

这里的对照目的是确认问题发生在本地 DNS、代理端 DNS，还是目标域名本身；它不是单纯为了更换协议。

socks5:// 通常先在本地解析目标域名；socks5h:// 会让代理端解析域名。遇到“出口 IP 正确但 DNS 仍显示本地运营商”或本地无法解析目标域名时，可以对照测试两种写法，但仍要以实际客户端和代理服务支持情况为准。

对照时只切换 socks5/socks5h，保持目标 URL、代理 IP、账号和超时不变，并记录解析结果、连接耗时和最终状态码。

本地无法解析目标域名时可优先测试 socks5h。出口 IP 正确并不能单独证明 DNS 解析链路符合预期，最终还要确认目标域名能否在相同条件下稳定访问。

Requests 的代理配置可参考官方高级用法。

代理协议、主机、端口和认证信息应以后台当前显示为准，也可对照代理设置帮助。

超时要区分连接阶段和读取阶段

连接超时和读取超时有什么区别

timeout=(10, 30) 表示连接阶段最多等待 10 秒，建立连接后每次读取最多等待 30 秒。它不是整个任务的绝对总时限。批量任务还应在外层设置最大重试次数和单任务总时限。

按连接、读取和状态码异常分别处理

```python
import requests
from requests.exceptions import (
ConnectTimeout,
HTTPError,
ProxyError,
ReadTimeout,
SSLError,
)

try:
response = requests.get(
"https://example.com/",
proxies=proxies,
timeout=(10, 30),
)
response.raise_for_status()
except ProxyError as exc:
print("代理连接或认证异常", type(exc).name)
except ConnectTimeout:
print("连接代理或目标站超时")
except ReadTimeout:
print("已连接，但读取响应超时")
except HTTPError as exc:
status_code = exc.response.status_code if exc.response is not None else "未知"
print("目标站返回 HTTP 错误", status_code)
except SSLError:
print("TLS 证书或握手异常")
```

日志需要记录哪些信息

生产日志建议记录异常类型、目标域名、状态码、耗时和脱敏后的代理标识，不记录完整认证信息。

根据报错现象选择对应处理动作

TLS 验证错误不要直接用 verify=False 掩盖

TLS 验证错误应先检查系统时间、CA 信任链、目标域名和中间网络设备。verify=False 会关闭 TLS 身份验证，不应作为生产修复方案，也不应因为它“能请求成功”就判断代理配置正确。

用出口检测和目标请求两步定位故障层级

1. 请求出口检测接口：确认状态码、耗时和公网出口 IP。
2. 使用同一 Session、同一代理 IP 和同一超时访问目标 URL。

如果第一步失败，继续查代理 URL、认证、依赖和网络；第一步成功而第二步出现 403、429 或验证码，说明代理接入已生效，应转查目标站规则、账号状态、Cookie、请求频率和请求特征。

建议把两步验证的结果写成同一条记录：代理协议、出口 IP、DNS 解析方式、连接耗时、读取耗时和最终状态码。这样能区分“代理连不上”和“代理已连通但目标站拒绝请求”。

FAQ

requests 默认完整支持 SOCKS5 吗？

通常需要安装 requests[socks] 对应的 SOCKS 依赖。依赖要安装在脚本实际使用的 Python 环境中。

HTTP 代理地址能用于 HTTPS 目标 URL 吗？

可以。常见方式是通过 HTTP 代理建立 CONNECT 隧道，具体协议和端口以交付信息为准。

连接成功后还需要设置超时吗？

需要。连接成功不代表读取一定及时完成，应分别设置 connect/read timeout，并在任务层设置重试上限。

什么时候考虑更换代理 IP？

只有在参数、认证和程序配置已确认正确，且失败稳定集中在少数出口时，才考虑更换代理 IP；目标站权限或账号问题不能靠更换出口解决。

配置验证完成后，可按公开采样和会话需求评估动态住宅代理 IP。