n1ro°
RU

Ошибки · Решение

WebSocket close code 1002 Protocol error: что означает

Endpoint закрыл WebSocket, потому что обнаружил нарушение протокола.

Редакция N1RO · Проверено

Короткий ответ

WebSocket close code 1002 — Protocol error. Endpoint закрыл WebSocket, потому что обнаружил нарушение протокола. Сверьте код с официальной поддержкой производителя и выполните только безопасные шаги.

Что означает ошибка

Endpoint закрыл WebSocket, потому что обнаружил нарушение протокола.

Возможные причины

  • Получен frame с недопустимой структурой.
  • Клиент нарушает правила opcode/fragmentation/control frames.
  • Proxy повреждает WebSocket framing.

Что проверить

  • Снимите frame-level trace без чувствительного payload.
  • Проверьте opcode, FIN/RSV bits и длины frame.
  • Сравните прямое соединение и путь через proxy.

Безопасные шаги

  1. Исправьте WebSocket framing в клиенте/библиотеке.
  2. Отключите несовместимое расширение для контрольного теста.
  3. Не заменяйте 1002 generic reconnect loop без устранения protocol violation.

Только безопасные обратимые действия. Опасные шаги — только по официальной инструкции и с пониманием рисков.

Когда нужен сервис

  • Если стандартная библиотека стабильно получает 1002 только через один proxy, передайте frame trace владельцу proxy.

Похожие ошибки

  • /errors/websocket-close-1007-invalid-frame-payload/
  • /errors/websocket-close-1008-policy-violation/
  • /errors/websocket-close-1009-message-too-big/

Что учитывать

Точная причина зависит от версии ПО/прошивки, полного текста ошибки и контекста. Официальная инструкция имеет приоритет.

Официальный источник

Расшифровка сверена с официальными страницами поддержки из источников ниже. Редакция N1RO не диагностировала ваш конкретный случай.