Ошибки · Решение
TLS alert 109 missing_extension: что означает и как исправить
В handshake отсутствует расширение, которое peer считает обязательным для продолжения.
Короткий ответ
TLS alert 109 missing_extension. В handshake отсутствует расширение, которое peer считает обязательным для продолжения. Сверьте код с официальной поддержкой производителя и выполните только безопасные шаги.
Что означает ошибка
В handshake отсутствует расширение, которое peer считает обязательным для продолжения.
Возможные причины
- Клиент не отправил extension, требуемый выбранным протоколом или серверной политикой.
- Прокси удалил extension из ClientHello/handshake.
- Устаревшая реализация не поддерживает обязательное расширение современного сценария.
Что проверить
- Посмотрите, какое extension ожидалось по server debug log.
- Сравните ClientHello рабочего и проблемного клиента.
- Проверьте прохождение extensions через TLS inspection/proxy.
Безопасные шаги
- Добавьте поддержку требуемого extension в клиент или обновите библиотеку.
- Исправьте proxy, если он фильтрует нужное расширение.
- Не отключайте требование без понимания его протокольной роли.
Только безопасные обратимые действия. Опасные шаги — только по официальной инструкции и с пониманием рисков.
Когда нужен сервис
- Если missing_extension выдаёт сервер без названия extension, нужен его handshake debug или trace с рабочим клиентом для сравнения.
Похожие ошибки
- /errors/tls-alert-unexpected-message/
- /errors/tls-alert-bad-record-mac/
- /errors/tls-alert-record-overflow/
Что учитывать
Точная причина зависит от версии ПО/прошивки, полного текста ошибки и контекста. Официальная инструкция имеет приоритет.
Официальный источник
Расшифровка сверена с официальными страницами поддержки из источников ниже. Редакция N1RO не диагностировала ваш конкретный случай.