Отладка: wscat, curl и логи соединений

Рукопожатие — обычный GET с несколькими обязательными заголовками, поэтому его можно показать curl'ом и прочитать, как читают ответ любого API. Три заголовка обязательны: Connection: Upgrade, Upgrade: websocket и Sec-WebSocket-Version: 13, плюс Sec-WebSocket-Key — случайная строка, из которой сервер обязан вычислить Sec-WebSocket-Accept. Успех выглядит как HTTP/1.1 101 Switching Protocols: соединение переключено, дальше по нему идут кадры, и curl будет ждать их бесконечно — флаг -N отключает буферизацию, а Ctrl-C возвращает терминал. Самое ценное в этом упражнении — увидеть код отказа: 400 значит, что сервер не узнал websocket-запрос, 403 — что Upgrader его узнал, но не пустил. Обе цифры разобраны ниже, после таблицы.

curl подтверждает транспорт, но не умеет разговаривать протоколом. Для диалога ставится wscat — утилита на Node, которая открывает соединение и превращает терминал в чат: каждая введённая строка уходит кадром, каждый входящий кадр печатается в ответ. Установка — npm install -g wscat, запуск — wscat -c ws://localhost:8080/ws. Заголовки передаются флагом -H, и это способ проверить авторизацию из тринадцатого урока без браузера: -H Authorization: Bearer с настоящим токеном. wscat показывает и служебные события — Connected, Disconnected с кодом и причиной, — что делает его удобным для проверки heartbeat из шестого урока: открыли соединение, ничего не трогали и смотрим, жив ли ping-цикл. Инструменты разработчика подобного рода экономят минуты: сервер проверяется без фронтенда, сборки и открытий вкладок.

Браузерные инструменты разработчика дают то, чего нет у curl и wscat: хронологию кадров конкретной вкладки. Откройте Network, отфильтруйте по типу WS, кликните соединение — появится панель сообщений, где каждый кадр лежит строкой со временем, направлением и размером: исходящие и входящие подсвечены разными цветами, а служебные ping и close видны как отдельные записи. Здесь диагностируются вещи, которых сервер не видит: дубликаты соединений после багованного reconnect из семнадцатого урока (две строки вместо одной), пачки из двадцатого урока с массивом items внутри, отсутствие close frame при закрытии вкладки. Клик по кадру раскрывает JSON, и расследование «почему интерфейс не отрисовал сообщение» заканчивается за минуту: либо кадра нет — виноват сервер, либо кадр есть — виноват обработчик на клиенте. В Firefox панель называется Frames, механика та же: фильтр по WS, клик по соединению, список кадров с направлением.

Отдельный класс проблем — соединение, которое числится открытым, но ничего не передаёт: NAT дома и корпоративный брандмауэр убивают тихое TCP-соединение по таймауту простоя, обычно через несколько минут тишины. Симптом узнаваем: клиент работал час, ушёл в фон, вернулся к молчащему интерфейсу, а onclose пришёл через минуты после фактической смерти сокета. Диагностика двухсторонняя: DevTools показывает последние ping и их время, логи read error на сервере дают момент обрыва, и разрыв между отметками — то самое окно молчания. Лечение — heartbeat из шестого урока: ping раз в тридцать-шестьдесят секунд держит соединение помеченным как живое и переводит смерть из «неизвестно когда» в «не позже одного периода пинга». Проверяется вручную за две минуты: wscat, брошенный на Wi-Fi, и телефон на мобильном интернете дают два разных времени жизни, и оба становятся длиннее после включения пинга.

Серверный лог — последний этаж, и его главная задача — не показать всё, а отделить норму от поломки. В readPump любая ошибка чтения заканчивается возвратом, и наивный лог печатает каждую: на мобильной сети соединения рвутся по несколько раз в минуту, и лог превращается в поток abnormal closure 1006 — это норма, а не инцидент. Полезная строка содержит userID, код закрытия и причину, а уровень зависит от кода: 1000 и 1001 — штатные уходы, их логируют на уровне debug; 1006 — обрыв, info; неожиданные коды вроде 1009 при обычных сообщениях — warn, потому что намекают на лимит из четырнадцатого урока. Записывать тела сообщений в лог не стоит: там персональные данные, а для разбора протокола достаточно типа конверта.