【Python LLM 调用踩坑】Connection error 终极解决方案！npm 代理导致阿里云通义千问接口连接失败

一、前言

最近用Python在搞 LLM 客户端，通过 OpenAI 接口、调用阿里云通义千问模型，本以为是简单的 API 调用，结果卡了1小时的 Connection error，排查了 API Key、代码语法、网络环境，最后才发现------罪魁祸首是我之前安装 OpenClaw 时，通过 npm 设置的全局代理！

二、问题现象

运行 Python LLM 客户端代码后，直接报错，核心报错信息如下（重点看 proxy 相关栈帧）：

bash 复制代码

❌ 调用LLM API时发生错误: Connection error.
Traceback (most recent call last):
  File "xxx/_base_client.py", line 1005, in request
    response = self._client.send(...)
  File "xxx/_http_client.py", line 914, in send
    response = self._send_handling_auth(...)
  File "xxx/_sync/http_proxy.py", line 288, in handle_request
    connect_response = self._connection.handle_request(...)
  File "xxx/_sync/connection.py", line 124, in _connect
    stream = self._network_backend.connect_tcp(**kwargs)
  File "xxx/socket.py", line 846, in create_connection
    sock.settimeout(timeout)
TypeError: 'str' object cannot be interpreted as an integer

The above exception was the direct cause of the following exception:

openai.APIConnectionError: Connection error.

⚠️ 关键特征：报错中出现 http_proxy、connect_tcp、socket.settimeout，且伴随 TypeError（看似类型错误，实则是代理导致的连锁反应）。

三、排查过程

一开始我以为是常规问题，逐一排查了以下几点，全部排除：

API Key 验证：确认阿里云通义千问的 API Key 正确，未过期、未欠费，权限正常；
代码语法检查：排查出 timeout 类型错误（从.env读取的是字符串，需转为int），修复后仍报 Connection error；
网络环境测试：浏览器访问阿里云通义千问官网正常，ping 接口地址无丢包；
代理排查：关闭梯子后，仍报错------豆包大法了半天，突然看到HTTP_PROXY和HTTPS_PROXY，然后突然反应过来，前几天在电脑上装了OpenClaw；

四、npm 代理劫持

回忆近期操作，我之前安装了 OpenClaw，通过 npm 命令设置了全局代理，命令如下：

bash 复制代码

setx HTTP_PROXY http://127.0.0.1:xxxx
setx HTTPS_PROXY http://127.0.0.1:xxxx

问题核心：

npm 设置的全局代理，会写入系统环境变量，影响所有依赖网络的程序；
Python 的 httpx、requests 等网络库，会自动读取系统的 HTTP_PROXY、HTTPS_PROXY 环境变量；
阿里云通义千问是国内服务，禁止代理访问，Python 强制走 npm 代理请求，直接被拦截，导致连接失败；
timeout 类型错误，是代理劫持后，请求超时参数被异常篡改（字符串类型）导致的连锁报错。

五、终极解决方案

不用手动关闭系统代理、不用卸载 OpenClaw、不用重启电脑，直接在 Python 代码 最顶部 加入3行代码，强制清空代理环境变量，让 Python 直连网络即可！

python 复制代码

import os
# 强制清空所有代理，避免被 npm/OpenClaw 代理劫持
os.environ['HTTP_PROXY'] = ''
os.environ['HTTPS_PROXY'] = ''
os.environ['NO_PROXY'] = '*'  # 所有地址都不使用代理