OpenAI Python SDK v3切HTTPX2

时间：2026 年 8 月 12-28 日（北京时间） 地点：旧金山 OpenAI / GitHub 主仓库 人物：OpenAI Python SDK 维护团队、Pydantic 团队（HTTPX2 作者）、OpenAI 开发者社区工程师 事件详情：OpenAI 在 8 月 12 日发布 Python SDK 3.0.0，将同步与异步 HTTP 客户端默认从 httpx 切换为 Pydantic 团队维护的 httpx2 分支，SDK 不再自动安装旧 httpx 和 certifi；3.5.0（8 月 27 日）锁依赖 httpx2>=2.7.0,<3，要求 Python ≥ 3.10。GitHub 仓库新增 httpx2.md 迁移指南与社区论坛置顶说明。文本、解析响应、流式接口默认路径不变（`OpenAI(timeout=30.0)` 仍可工作），自定义 HTTP 客户端、Transport、Timeout、Limits 等对象需从 httpx 改为 httpx2 命名空间；DefaultHttpx2Client/DefaultAsyncHttpx2Client 助手保留官方推荐的连接池、超时与重定向默认值；TLS 信任链从 certifi 转向系统 CA，SSL_CERT_FILE/SSL_CERT_DIR 可显式覆盖；为旧实现留有运行时 legacy httpx escape hatch，但官方明确为"临时"。 背景：Pydantic 团队因 httpx 长期维护节奏与 OpenAPI 代码生成需求，于 2025 年下半年 fork 出 httpx2；HTTPX2 并非 HTTP/2 协议，而是 httpx 的 Pyodide-friendly 续作，重点解决与 Pydantic 类型系统的耦合及 TLS 在容器化部署中的实战问题。OpenAI 作为 httpx 重度使用方，把 SDK 默认客户端换到 httpx2 等于一次性把"AI 模型调用 + 类型安全 + TLS 配置"三件事重新对齐；3.0 大版本号 + BREAKING CHANGES 语义，也意味着 Stainless 的代码生成管道切换完成。 影响：对直接调 `from openai import OpenAI` 的轻量用户，pip install openai 升级后零代码改动；对自定义 http_client、Retrofit 风格 proxy、企业 TLS 拦截代理的金融/医疗大客户，是一次强制迁移窗口；RESPX、httpx-mock、Sentry/OpenTelemetry 等中间件必须升级到 HTTPX2 兼容版本，否则 mock 与链路追踪会失效。生态侧，LangChain、LlamaIndex、Anthropic SDK、Anthropic-Bedrock、Qwen-Agent 等"以 openai-python 为事实标准"的库都会被推动同步升级；HTTPX2 也因此反向获得"被 OpenAI 默认"的权威背书，可能成为 2027 年 Python AI 客户端的事实基线。 总结：OpenAI Python SDK 3.0 切 HTTPX2 不是模型升级，而是把 SDK 自身的网络栈、Pydantic 类型、TLS 信任链与 Stainless 代码生成"重新锁一遍版本"，对开发者是"先升级再看"的运维升级，对 OpenAI 而言是把基础设施权收回自己手中的一次静悄悄的标准化操作——所有依赖 OpenAI 兼容协议的库都必须主动跟进，否则将无法享受官方客户端的稳定性红利。 参考来源： - https://github.com/openai/openai-python/blob/main/httpx2.md （OpenAI 官方迁移指南） - https://github.com/openai/openai-python/releases/tag/v3.0.0 （OpenAI 3.0.0 release notes） - https://github.com/openai/openai-python/releases/tag/v3.5.0 （OpenAI 3.5.0 release notes） - https://community.openai.com/t/openai-python-sdk-3-0-0-now-installing-needing-pydantic-teams-httpx2-fork/1391506/1 （OpenAI 开发者社区公告） - https://gokawiil.com/article/336560 （解读：OpenAI Migrating to HTTPX2） - https://hitreader.com/post/openai-python-sdks-httpx2-migration-what-actually-changes （深度分析：HTTPX2 Migration Guide） - https://tokenfeed.ai/openai-sdk-turns-30-breaks-everything-politely （OpenAI SDK 3.0 评论） - https://updateshub.net/en/source/openai-python （OpenAI Python SDK 更新索引）