Перезапуск процесса меняет обработчик interaction, но не схему slash-команды в Discord. Название, описание и options живут в удалённом реестре application commands и обновляются отдельным HTTP-запросом. Поэтому новый код может работать, а клиент продолжит показывать старые параметры.
Не начинайте с массового удаления. Сначала запишите application ID, окружение, scope команды и ID тестового сервера. Затем получите реестр через API без вывода bot token в консоль. Это быстро отличает пропущенный шаг регистрации от кеша клиента или деплоя не того приложения.
Один релиз затрагивает два независимых слоя
| Что изменилось | Где хранится | Что увидит пользователь |
|---|---|---|
| Логика handler | Запущенный процесс бота | Новое поведение после interaction |
| Описание и options | Application Commands API | Новая форма slash-команды |
| Guild-команда | Реестр конкретного guild | Изменение только на тестовом сервере |
| Global-команда | Глобальный реестр приложения | Команда для установок приложения |
| Права и contexts | Объект команды и настройки guild | Доступность в канале, DM или роли |
Первый контрольный вопрос: был ли в pipeline отдельный register-commands шаг и завершился ли он ответом Discord API. Сообщение «бот запущен» ничего не говорит о регистрации. В журнале достаточно сохранить endpoint без секрета, HTTP status, application ID, scope и количество возвращённых команд.
Сверка начинается с удалённого объекта
# Global commands of the current application
curl -sS \
-H "Authorization: Bot $DISCORD_BOT_TOKEN" \
"https://discord.com/api/v10/applications/$APPLICATION_ID/commands"
# Commands registered only in the test guild
curl -sS \
-H "Authorization: Bot $DISCORD_BOT_TOKEN" \
"https://discord.com/api/v10/applications/$APPLICATION_ID/guilds/$GUILD_ID/commands"В ответе сравните не только name. Полезны id, application_id, type, description, options, contexts и default_member_permissions. Токен оставляют в переменной окружения, ответ с внутренними идентификаторами не публикуют целиком. Если application_id не тот, исправлять команду в текущем реестре нельзя: сначала найдите ошибку конфигурации релиза.
Guild и global могут иметь одинаковое имя
Discord разрешает команде с одним именем существовать одновременно в global и guild scope. Из-за этого тестовая версия может перекрывать ожидания на одном сервере, тогда как остальные серверы получают global-вариант. Проверьте оба списка и тип команды: CHAT_INPUT, USER и MESSAGE имеют отдельные пространства имён.
- Для быстрой проверки публикуйте новую схему как guild-команду на отдельном сервере.
- После проверки перенесите ту же версию схемы в global scope.
- Удалите временную guild-копию только после подтверждения global-объекта.
- Не оценивайте результат по одному клиенту: сравните API и затем перезапустите клиентский просмотр.
- Храните хеш нормализованной схемы рядом с номером релиза.
Upsert безопаснее бесконечного create
POST команды с уже занятым именем в том же типе и scope работает как upsert. Для точечного изменения также есть PATCH по command ID. Bulk overwrite удобен, когда файл схемы является полным источником истины, но он заменяет весь список: пропущенная в payload команда исчезнет. Перед таким запросом сохраните текущий JSON и покажите diff в CI.
Не запускайте регистрацию при каждом старте каждой реплики. Одновременные экземпляры создают лишние запросы и затрудняют разбор результата. Выполняйте миграцию команд один раз на релиз, под отдельной ролью pipeline, а приложение пусть только обрабатывает interactions.
Поля options обновляются целиком
При редактировании Discord полностью заменяет переданные поля их новыми значениями. Генератор должен отправлять завершённый массив options, локализации и ограничения, а не рассчитывать на неявное слияние вложенных элементов. Сортируйте схему детерминированно, иначе обычная перестановка будет выглядеть как содержательное изменение.
Отдельно проверьте, что deploy использует credentials именно того приложения, которое установлено на сервере. Совпадение имени бота и аватара не доказывает совпадение application ID. Для staging и production нужны разные явные переменные и запрет на значение по умолчанию.
Приёмка проходит от формы до handler
- Получить guild-объект и убедиться, что новая option уже есть в API.
- Открыть команду под обычным участником и проверить форму ввода.
- Отправить interaction с новым параметром и записать command ID и версию handler.
- Повторить под ролью с ограниченными правами.
- Сравнить global-объект после публикации и убрать тестовую guild-копию.
- Проверить, что старая option больше не принимается серверной валидацией.
Для разбора достаточно схемы без токена
Если команда всё ещё старая, подготовьте нормализованный JSON желаемой схемы, ответы GET для global и guild без заголовков авторизации, application ID, guild ID теста и лог шага регистрации. По этим данным видно, где расходятся источники. Bot token и подписи interactions в материалы диагностики не включают.