OpenAI、OSS ライブラリ openai-python の内部 HTTP クライアントを HTTPX2 に移行──certifi 依存の廃止と OS トラストストア標準化
openai-python SDK の内部 HTTP クライアントが従来の httpx から HTTPX2 へ移行し、証明書検証の仕組みやカスタムクライアントの型定義に大きな変更が発生する。
リリース: 2020-10-25 · 読了 3 分記事の要約
1. 核心（What）
- OpenAI Python SDK は同期および非同期の HTTP クライアントとして HTTPX2 を標準採用した。
- SDK のインストール時に従来の `httpx` パッケージは自動でインストールされなくなった。
- 証明書検証の参照先が certifi の CA バンドルから OS のトラストストアへと変更された。
- 従来の `DefaultHttpxClient` などの名称も維持されるが、内部では HTTPX2 クライアントを構築する仕様となった。
2. 影響（Why）
- コンテナ環境での接続エラー防止: OS トラストストア参照への変更により、最小構成コンテナやプロキシ環境で証明書検証エラーが起きるため、事前に対策を講じる必要がある。
- 国内 SaaS のインフラ検証負荷: [国内 AI SaaS 企業] のような商用サービス運営者は、依存ライブラリの更新に伴うテストスイートの改修とモックライブラリの追随コストが発生する。
3. 根拠・詳細（How）
- OS トラストストアと証明書設定: HTTPX2 は certifi ではなく OS のトラストストアを使用するため、証明書のない最小コンテナでは `SSL_CERT_FILE` の設定や `verify` 引数による明示的な `ssl.SSLContext` の指定が必須となる。
- レガシー互換のエスケープハッチ: 移行期の一時的な対応として、`cast(Any, httpx.Client())` を用いることでレガシーな `httpx` クライアントを強制注入できるが、静的型チェック (mypy/Pyright) ではエラーとなるため型アノテーションの調整が必要。
4. 展望・課題（Next）
- レガシーサポートの将来的な廃止: 一時的に提供されているレガシー HTTPX クライアントのサポートは将来的に終了する予定であり、全面的に HTTPX2 への移行を完了させる必要がある。