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

Что осталось у участника

Представьте тестовое сообщество, где участника перевели из стажёров в выпускники. До перехода у него были «Стажёры» и выданная модератором роль «Доклады». После перехода ожидаются «Выпускники» и «Доклады». Запишите идентификаторы ролей из настроек интеграции. У разных ролей могут быть одинаковые названия.

Фактические ролиКуда смотреть
«Стажёры» и «Доклады»Получил ли обработчик актуальный статус и отправил ли запрос на выдачу новой роли
«Стажёры», «Выпускники» и «Доклады»Отправил ли обработчик запрос на снятие старой роли и каким был ответ Discord
Только «Доклады»Что произошло с выдачей новой роли после снятия старой
Только «Выпускники»Какие назначения обработчик считает управляемыми и почему он затронул ручную роль

Для одной попытки соберите идентификаторы сервера, участника и каждой затронутой роли. В ответе на успешное добавление или снятие роли Discord возвращает HTTP 204 без тела. Если клиент помечает операцию как ошибку сразу после 204, посмотрите, не пытается ли он читать пустой ответ как JSON. Фактический результат проверьте повторным чтением участника.

Проверьте переход на тестовом сервере

Снимите список ролей до перехода. Измените статус и запишите отдельно результат выдачи новой роли и снятия прежней. Затем имитируйте временный сбой одной из операций. При повторе обработчик должен перечитать актуальный статус и довести список управляемых ролей до нужного состояния. Ручное назначение «Доклады» должно пережить обе попытки.

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

Событие пришло позже, чем сменился статус

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

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

Если состав ролей верен, а участник видит лишний канал, продолжите с

Проверенные источники