浏览器能打开,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 判断比改环境变量更可控。

几条经验

  1. "浏览器能访问"不等于"程序能访问"。两者的代理实现完全不同,遇到内网地址超时而浏览器正常,优先怀疑代理。
  2. Windows 的 ProxyOverride 对 Python 无效,别指望它。要么代码里 trust_env=False,要么在进程环境里显式配置代理。
  3. 172.16.*.* 这种通配写法不是通用语法,httpx 的排除规则只认域名形式的通配。
  4. 超时问题先加日志定位到具体是哪一行请求。这次如果没有 /models 那行 200 的日志,很容易误判成同一个请求没修好,实际上是下一条链路又踩了同一个坑。
  5. 辅助请求要能降级。模型列表这种用于"锦上添花"的请求,失败时不应该让主流程判死。
  6. 绕过代理要按地址判断,不要一刀切,否则会把依赖代理的公网调用一起弄坏。
posted @ 2026-11-10 17:10  新*  阅读(30)  评论(0)    收藏  举报