Новый токен требует перезапуска процесса, а ошибка offline может быть связана также с intents, неправильным приложением или несколькими экземплярами.

Ниже — практический порядок проверки. Он помогает сначала локализовать источник сбоя, затем внести минимальное изменение и проверить результат на реальном сценарии.

Как проявляется проблема

Бот виден offline, команды не отвечают, а процесс при этом может оставаться запущенным без явной ошибки в панели.

Что проверить в первую очередь

  • Зафиксируйте точное время ошибки, пользователя, объект или операцию, на которой она появилась.
  • Сравните успешный и проблемный сценарии: входные данные, права, окружение, версию приложения и последовательность действий.
  • Проверьте последние изменения в коде, настройках, интеграциях, инфраструктуре и фоновых заданиях.
  • Сохраните связанные логи и идентификаторы запроса до повторного запуска или очистки кеша.

Основные причины

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

  • Процесс продолжает читать старую переменную окружения.
  • Скопирован токен другого приложения или бота.
  • После изменений отключены обязательные privileged gateway intents.
  • Процесс падает на login, но supervisor бесконечно его перезапускает.

Пошаговая диагностика

  • Посмотрите первый лог запуска до подключения к gateway.
  • Сверьте application id и безопасный fingerprint токена.
  • Проверьте статус процесса в systemd, Docker или PM2.
  • Сопоставьте используемые intents с настройками Developer Portal.

Как исправить

Исправление лучше делать небольшими проверяемыми шагами. Перед изменением рабочих данных сделайте резервную копию или подготовьте обратную миграцию.

  • Обновите секрет в фактическом окружении процесса и перезапустите его.
  • Включите только необходимые intents в коде и панели.
  • Остановите лишние экземпляры, если они конфликтуют.
  • Добавьте readiness после успешного события ready и понятный лог причины остановки.

Как проверить результат

  • Бот получает ready и отвечает на тестовую команду.
  • После перезапуска используется новая версия секрета, старый токен не работает.
  • Повторите исходный проблемный сценарий и минимум один пограничный случай.
  • Проверьте логи после исправления: отсутствие ошибки в интерфейсе еще не гарантирует корректную обработку.
  • Убедитесь, что правка не нарушила соседние операции, права других ролей и повторную обработку события.

Чего не стоит делать

  • Не отключайте проверки безопасности и разграничение доступа только ради исчезновения ошибки.
  • Не меняйте массово рабочие данные без выборки, резервной копии и заранее подготовленного отката.
  • Не запускайте повторно платежи, рассылки, возвраты или фоновые задачи, пока не проверена идемпотентность.
  • Не оставляйте токены, пароли, персональные данные и полные тела запросов в открытых логах.

Как не допустить повторения

  • Храните токены вне репозитория.
  • Проверяйте подключение и команды после каждой ротации автоматическим smoke test.

Что подготовить для разбора

  • Ссылку на проблемную страницу, метод API, задание, отчет или интеграцию.
  • Точное описание ожидаемого и фактического результата без секретных ключей и паролей.
  • Фрагмент лога за нужный период, идентификатор операции и пример входных данных.
  • Список последних изменений и информацию о рабочем окружении.

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

Можно ли исправить проблему без полной переделки?

Чаще всего да. Если сначала найти точку расхождения, достаточно локальной правки в проверке, транзакции, обработчике события, настройке или запросе к данным.

Почему ошибка появляется не у всех?

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

Итог

Статус online появляется после успешной авторизации gateway, поэтому начинать нужно с первого ответа Discord и окружения процесса.

Если самостоятельно локализовать причину не получилось, я могу разобрать логи и код, воспроизвести ошибку, предложить безопасную правку и проверить ее на рабочем сценарии.