浏览器能打开,Python 却超时:httpx 没读懂 Windows 代理的排除列表
AI 生成声明:本文内容由 AI 生成或经 AI 辅助完成,请注意甄别。
背景
给一套数据平台做"测试连接"功能:用户在凭证里填 OpenAI 兼容的地址(内网 vLLM / GPUStack,形如 http://<内网IP>:8000/v1),点一下按钮,后端去请求 /v1/models 和 /v1/chat/completions 验证连通性和模型可用性。
现象很怪:
- 开着公司代理时,点"测试连接"一直转圈,最后超时;
- 关掉代理立刻正常;
- 用浏览器直接访问
http://<内网IP>:8000/v1/models,秒开。
同样的 URL,浏览器行、Python 不行,直觉会怀疑服务端限流或鉴权,但日志显示请求根本没到达服务端——请求被塞进代理了。
第一层结论:代理的问题
先做个最小对比。同一个 URL、同一套请求头:
| 客户端配置 | 结果 |
|---|---|
| 浏览器 | 正常返回 |
| httpx(默认配置) | 挂住,直到 ReadTimeout |
httpx(trust_env=False) |
200,耗时 0.06s |
差别只在 trust_env。它的默认值是 True,意思是"尊重环境里的代理配置"——在 Windows 上,这个"环境"还包括注册表里的系统代理设置。
为什么我明明配了排除列表?
排查到这里的第一反应是:代理软件的排除列表里不是写了 172.16.*.* 吗?打开注册表一看,确实写了(下面把具体地址打了码):
HKCU\Software\Microsoft\Windows\CurrentVersion\Internet Settings
ProxyEnable : 1
ProxyServer : <代理IP>:<端口>
ProxyOverride : 10.1.*.*;10.10.*.*;10.221.*.*;172.16.*.*;localhost;...
配置是对的。但 Python 这边有三道坎,任何一道都足以让排除规则失效。
坎一:CPython 根本不读 ProxyOverride
urllib.request.getproxies() 在 Windows 上会调用 getproxies_registry()。看它的实现就知道,这个函数只读 ProxyEnable / ProxyServer / AutoConfigURL,从来没读过 ProxyOverride,返回的字典里根本没有 no 这个键:
>>> urllib.request.getproxies()
{'http': 'http://<代理IP>:<端口>',
'https': 'http://<代理IP>:<端口>',
'ftp': 'http://<代理IP>:<端口>'}
排除列表在注册表里躺着,Python 视而不见。
坎二:httpx 只会从 no 键取排除项
httpx 构造客户端时会调用 get_environment_proxies(),它对"不走代理"的判断只来源于:
proxy_info = getproxies()
for scheme in ("http", "https", "all"):
if proxy_info.get(f"no_{scheme}"):
...
no 没有值,排除规则就是空的,于是所有主机一律走代理。
坎三:就算读到了,172.16.*.* 也不是它认的格式
httpx 用来匹配排除规则的 URLPattern 只支持 *.example.com 这类域名通配,对 IPv4 中间夹通配符的写法没有支持。is_ipv4_hostname("172.16.*.*") 返回 False,最后会拼出 all://*172.16.*.*,而真实主机是 172.16.x.x,匹配不上。
结论:浏览器走的是 WinINET,它尊重 ProxyOverride;Python 走的是自己的一套读取和匹配逻辑,既不读这个字段,也不支持这种通配。所以"我在代理里排除了这些地址"对 Python 完全无效。
修复一:让探测请求直连
第一步先让卡住的那个请求直连,并且连不上就快速降级——这个 /models 请求只是用来做模型名匹配的辅助动作,不该让整个连接测试失败:
# trust_env=False:跳过系统代理;
# connect 单独设 5s:连不上时快速降级,不占用整个测试的等待时间
with httpx.Client(timeout=httpx.Timeout(30.0, connect=5.0),
trust_env=False) as models_client:
models_resp = models_client.get(models_endpoint, headers=headers)
对应的异常处理也从"直接返回失败"改成"打日志 + 继续走后面的真实对话测试":
except httpx.TimeoutException:
logger.warning(f"查询模型列表超时,降级直接测试模型: {model_name}")
except httpx.ConnectError:
logger.warning(f"无法连接/models端点,降级直接测试模型: {base_url}")
改完后日志显示 /models 0.6 秒就返回 200 了。
但又卡住了:日志把锅甩给了下一行
{"查询可用模型列表: http://<内网IP>:8000/v1/models"}
{"HTTP Request: GET .../models HTTP/1.1 200 OK"}
{"配置模型 <配置的模型名> 不在列表中,自动使用唯一可用模型: <实际模型名>"}
.... 然后就没了
200 已经回来了,说明探测请求彻底通了。卡住的是下一行之后的对话请求——它由业务里的 LLMClient 发出,而那个类内部自己创建了 httpx.AsyncClient(timeout=8000.0),同样默认 trust_env=True,于是又被同一个代理接走,这次会挂 8000 秒。
这一点值得强调:连接测试只是表象,工作流里真正调用大模型的也是同一个 client,只要开着代理,线上任务同样会挂。
修复二:按地址判断要不要绕过代理
全局关掉代理不行——公网 API(比如 DeepSeek)可能确实需要代理。正确做法是按目标地址区分:私网直连,公网照旧。
# 私网地址绕过系统代理:Windows 的 ProxyOverride Python 读不到
_host = urlparse(self.base_url or '').hostname or ''
try:
_is_lan = ipaddress.ip_address(_host).is_private
except ValueError:
_is_lan = _host in ('localhost',)
self.client = httpx.AsyncClient(timeout=8000.0, trust_env=not _is_lan)
ipaddress.is_private 直接覆盖了 10.0.0.0/8、172.16.0.0/12、192.168.0.0/16、127.0.0.0/8 这些网段,不用自己算掩码。验证结果:
http://<内网IP>:8000/v1 -> trust_env = False (直连)
http://<另一内网IP>:18899/v1 -> trust_env = False (直连)
http://localhost:8000/v1 -> trust_env = False (直连)
https://api.deepseek.com/v1 -> trust_env = True (走代理)
https://api.openai.com/v1 -> trust_env = True (走代理)
那直接用 NO_PROXY 环境变量不行吗?
试过,不建议。Windows 上 getproxies() 的实现是:
def getproxies():
return getproxies_environment() or getproxies_registry()
只要环境变量里有任何代理相关设置,返回值非空,注册表就被整体跳过。也就是说,只设 NO_PROXY 会让进程立刻变成"所有请求都直连",连本该走代理的公网 API 也不走了。想做细粒度控制,按 URL 判断比改环境变量更可控。
几条经验
- "浏览器能访问"不等于"程序能访问"。两者的代理实现完全不同,遇到内网地址超时而浏览器正常,优先怀疑代理。
- Windows 的
ProxyOverride对 Python 无效,别指望它。要么代码里trust_env=False,要么在进程环境里显式配置代理。 172.16.*.*这种通配写法不是通用语法,httpx 的排除规则只认域名形式的通配。- 超时问题先加日志定位到具体是哪一行请求。这次如果没有
/models那行 200 的日志,很容易误判成同一个请求没修好,实际上是下一条链路又踩了同一个坑。 - 辅助请求要能降级。模型列表这种用于"锦上添花"的请求,失败时不应该让主流程判死。
- 绕过代理要按地址判断,不要一刀切,否则会把依赖代理的公网调用一起弄坏。

浙公网安备 33010602011771号