Проверка сертификатов ломается после перехода на HTTPX2

28 августа OpenAI перевела официальный Python-SDK на HTTPX2: синхронный и асинхронный клиенты теперь работают на нём. HTTPX2 ставится вместе с openai, а прежний пакет httpx SDK больше за собой не тянет. Что это меняет для кода, который работает с HTTP-слоем SDK, расписано в руководстве по миграции в репозитории openai-python на GitHub.
HTTPX2 продолжает HTTPX. Это форк httpx 0.28.1 с тем же публичным API (те же Client, AsyncClient, Response), и главное отличие в имени. В репозитории проекта Pydantic объясняет, что берёт его под опеку, потому что сам HTTPX в последнее время развивался вяло, а пользователям нужен надёжно поддерживаемый путь со своевременными обновлениями безопасности. httpx стал стандартным клиентом для целого поколения API-SDK, включая OpenAI, но работа над проектом замедлилась: issues и пул-реквесты копились без ревью.
Если клиент OpenAI или AsyncOpenAI создаётся без своего http_client, вызовы API, разобранные модели ответов, стриминг, аутентификация, повторы и числовые таймауты работают как раньше. Отдельно ставить ничего не нужно, хватает pip install openai. Ломается другое: если приложение импортировало httpx только потому, что его транзитивно ставил старый SDK, теперь эту зависимость надо прописать самим или перевести импорты на httpx2.
Сертификаты из системы
Самое заметное изменение касается и тех, кто не трогает HTTP-клиент вообще. HTTPX проверял сертификаты по набору корневых CA из пакета certifi. HTTPX2 вместо этого опирается на хранилище доверенных сертификатов операционной системы, а certifi SDK больше не устанавливает.
OpenAI прямо называет три сценария, где проверка сертификатов может перестать проходить: минимальные контейнерные образы без системных CA, корпоративные прокси, которые вскрывают TLS-трафик для инспекции, и развёртывания, где использовался свой или правленый набор certifi.
Варианта починки два. Первый: поставить нужные CA в системное хранилище. Второй: указать набор явно через SSL_CERT_FILE=/path/to/ca-bundle.pem или каталог с сертификатами через SSL_CERT_DIR. Обе переменные читаются при trust_env=True, а это значение по умолчанию. Для полного контроля на своём клиенте можно передать ssl.SSLContext через параметр verify: DefaultHttpx2Client(verify=ssl_context), для асинхронного кода DefaultAsyncHttpx2Client. Транспорт на aiohttp в SDK использует те же настройки TLS из HTTPX2.
Что переписывать в своём клиенте
Кто передаёт SDK собственный клиент, должен собирать его на HTTPX2. Хелперы DefaultHttpx2Client и DefaultAsyncHttpx2Client сохраняют рекомендованные SDK значения таймаутов, пула соединений и редиректов. Голые httpx2.Client и httpx2.AsyncClient тоже принимаются, но тогда действуют их собственные умолчания. Старые имена DefaultHttpxClient и DefaultAsyncHttpxClient по-прежнему работают, только создают уже клиенты HTTPX2. То же правило касается модульной настройки через openai.http_client.
Объекты конфигурации меняются один к одному: Client, AsyncClient, Timeout, URL, Limits, HTTPTransport, AsyncHTTPTransport и MockTransport берутся из httpx2 вместо httpx. Числовые таймауты и строковые URL остаются как есть. Подклассы транспортов, смонтированные транспорты, интеграции с прокси и инструментирование пула соединений должны работать с транспортными интерфейсами HTTPX2. Обработчики аутентификации и event hooks получают объекты запроса и ответа из HTTPX2, так что аннотации и базовые классы тоже придётся поменять. Сторонние средства трассировки, middleware и интеграции аутентификации должны поддерживать HTTPX2 явно.
Причина в том, что пакеты разные. По документации Pydantic, httpx2.Client и httpx.Client - разные классы, как и Response, Request, Timeout. Библиотека, которая проверяет isinstance против httpx.Client, отвергнет клиент HTTPX2, а httpx.HTTPError не поймается в except httpx2.HTTPError. Ставить оба пакета в одно окружение при этом можно, они не конфликтуют.
Разобранные модели ответов SDK не меняются. Но у нативного клиента сырые ответы через with_raw_response отдают httpx2.Response и httpx2.Request, неразобранный ответ запрашивается через cast_to=httpx2.Response, а обёртки стриминга тоже возвращают объекты HTTPX2. Ловить в коде OpenAI советует собственные исключения SDK вроде openai.APITimeoutError и openai.APIConnectionError, у которых транспортная первопричина теперь тоже из HTTPX2.
Тесты и RESPX
Моки должны перехватывать запросы HTTPX2 и возвращать ответы HTTPX2, например через httpx2.MockTransport с функцией-обработчиком. С RESPX, популярной библиотекой для подмены HTTP-запросов в тестах, придётся обновиться до совместимой с HTTPX2 версии или форка: версия, которая патчит только старый HTTPX, клиент SDK по умолчанию не перехватит.
Экстра openai[aiohttp] теперь использует транспорт, написанный под HTTPX2, и не ставит ни старый HTTPX, ни внешний адаптер httpx-aiohttp. DefaultAioHttpClient() возвращает обычный httpx2.AsyncClient.
Аварийный выход
Для тех, кто завязан на транспорт, интеграцию или моки, работающие только с HTTPX, оставлен обходной путь: поставить httpx вручную и передать его клиент в SDK. Поддержка есть только во время выполнения. Публичные аннотации SDK принимают лишь клиенты HTTPX2, поэтому mypy, Pyright и похожие инструменты на старом клиенте падают, и OpenAI предлагает обернуть его в cast(Any, httpx.Client()) или поставить точечный type-ignore. Такой клиент отдаёт запросы, ответы и исключения из семейства HTTPX, и cast_to=httpx2.Response не превращает старый ответ в новый. Тот же приём работает с существующей интеграцией httpx-aiohttp: по словам OpenAI, этот путь покрыт отдельными тестами совместимости, включая реальный запрос через транспорт aiohttp.
Старую зависимость придётся ставить и сопровождать самим. Срок у этого пути в руководстве не обещан:
Поддержка устаревшего HTTPX оставлена как подспорье для миграции и может быть прекращена.
Дальше
Claude Hub спрашивает, почему вы вернулись в обычный чат
По данным TestingCatalog, при выходе из режима Hub обратно в обычный чат Claude просит объяснить причину. Сам Hub, предположительно, оркестрирует задачи и пока остаётся во внутреннем тестировании Anthropic.
Читайте также
- OpenAI выпустила официальный CLI для своего API
- OpenAI отключит GPT-4o в январе 2027 и зовёт на Luna
- Decisions API от OpenAI вышел в публичную бету для всех
- OpenAI научила Luna выбирать ответ за 150 миллисекунд
- Память ChatGPT о работе на Mac обходится без скриншотов
- Responses API научился хранить рассуждения между ходами
Комментарии
Пока никто не написал. Будьте первым.
Присоединяйтесь к разговору
Войдите, чтобы оставить комментарий. Он появится после модерации.

