На экране строка с текстом ошибки

Приложение показало сообщение, и в нём набор непонятных слов. Хорошая новость: текст называет причину. Ниже — таблица формулировок и перевод каждой на человеческий язык.

Кто прислал сообщение — это первый вопрос

Текст ошибки почти всегда пишет не приложение. Оно пересказывает то, что ему ответила система или сервер, часто прямо на английском и без перевода. Поэтому первое, что стоит сделать, — понять источник: от него зависит, где искать причину.

• Системные сообщения (в тексте попадаются java, net, socket, permission) — прислала операционная система устройства. Ищите причину в самом устройстве.
• Сетевые сообщения (timeout, EOF, connection refused, handshake) — прислал сетевой обмен. Ищите причину в адресе или в сети.
• Сообщения о разборе (config, parse, invalid, unsupported) — приложение не поняло то, что ему дали. Ищите причину в строке.
• Числа вроде 403, 502 — ответил узел на той стороне. Он жив, но запрос не пустил.

Таблица формулировок

Три правила чтения ошибок

1. Смотрите на последнюю строку, а не на первую

   Длинные сообщения строятся сверху вниз от общего к частному. Настоящая причина — в самом низу: там написано, что именно не получилось. Верхние строки лишь сообщают, где это произошло.

2. Отличайте «молчит» от «отказал»

   Молчание приходит по таймеру и всегда через одинаковое время — значит, узла нет или он недоступен. Отказ приходит мгновенно и с текстом — значит, узел есть и он вас не пустил. Первое лечится сменой адреса, второе иногда тоже, но причины разные.

3. Не гуглите текст целиком

   В сообщение обычно попадает адрес или номер порта, и поиск по такой строке не найдёт ничего. Ищите по двум-трём ключевым словам без чисел — или посмотрите таблицу выше.

Как снять текст, если он мелькает

Сообщения об ошибках соединения часто держатся на экране пару секунд. Прочитать длинную строку за это время невозможно, а без текста разбор превращается в гадание. Три способа поймать её целиком.

1. Снимок экрана сразу после нажатия. Нажали подключение — и тут же делаете снимок. Даже если промахнулись по времени, повторить дешевле, чем гадать.
2. Запись экрана. Включаете запись, подключаетесь, останавливаете. Потом ставите на паузу на нужном кадре — так ловится и то, что мелькнуло на четверть секунды.
3. Повтор подряд. Многие сообщения при повторной попытке остаются дольше или дублируются в списке событий приложения, если он у вашей сборки есть.

Сняли — закройте на снимке всё, что похоже на адрес и на длинный набор символов, прежде чем кому-то показывать. Для разбора хватает первых слов сообщения, а адрес из него — это часть вашего доступа.

Если текста нет вовсе

Бывает и так: подключение обрывается молча. Это не значит, что ошибки нет — значит, приложение не успело её показать. Разбирать надо по поведению, а не по надписи: крутится и обрывается.

Обратный случай — сообщение мелькнуло и исчезло. Попробуйте подключиться ещё раз и сразу сделать снимок экрана: читать с фотографии проще, чем ловить глазами.

Если не помогло

Когда формулировки в таблице нет, ориентируйтесь на поведение. Ошибка при вставке строки — это одна ветка, ошибка при подключении — другая, ошибка при запуске приложения — третья. Момент появления сообщения говорит больше, чем его текст.

Частые вопросы