Charles 抓包导致 langchain 报错的解决方案

在开发环境中，使用 Charles 作为代理服务器来监控 Python 应用（如 LangChain 或 OpenAI SDK）的网络流量时抓包失败，显示 You may need to configure your browser or application to trust the Charles Root Certificate. See SSL Proxying in the Help menu

问题的核心在于，Python 生态中主流的 HTTP 客户端库，包括 requests 及其异步对应 httpx（LangChain 与新版 OpenAI SDK 的底层依赖），默认不调用操作系统的信任库。它们依赖于一个名为 certifi 的 Python 包，该包提供了一套独立的、硬编码的、受信任的根证书颁发机构（CA）证书集。因此，即使 Charles 根证书在系统中受信任，但它并未包含在 Python 环境所使用的 certifi 证书包内。这导致当 Python 应用尝试通过 Charles 代理与 HTTPS 端点通信时，由于无法在 certifi 的信任链中找到有效的根证书，SSL 证书验证失败。

方法一：设置环境变量

首先在 Charles 中导出 SSL 证书，然后在终端里设置环境变量：

macOS / Linux:

export SSL_CERT_FILE="/path/to/charles.pem"
python your_script.py

Windows (PowerShell):

$env:SSL_CERT_FILE = "C:\path\to\charles.pem"
python your_script.py

方法二：把 Charles 证书加进 certifi 的信任列表里

在 Charles 中导出 SSL 证书
找到 Python 证书包位置：

import certifi
print(certifi.where())

把 Charles 证书加进去：

# macOS / Linux
cat /path/to/charles.pem >> /path/to/certifi/cacert.pem

# Windows
type C:\path\to\charles.pem >> C:\path\to\certifi\cacert.pem

方法三：代码中关闭安全检查

修改代码，在运行时跳过验证：

import httpx
from langchain_openai import ChatOpenAI

insecure_client = httpx.Client(verify=False)
insecure__async_client=httpx.AsyncClient(verify=False)

llm = ChatOpenAI(
    # ...
    http_client=insecure_client,
    async_client=insecure__async_client
)