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

Не выдавайте роль заново вслепую. Возьмите одного участника и сравните три факта: есть ли role ID в Guild Member, есть ли сохранённое expires_at и существует ли задача на удаление. Это показывает, восстанавливать расписание, отменять устаревшую запись или искать ошибочный remove role.

После рестарта ломается один из трёх слоёв

Discord roleЗапись о срокеЗадачаДействие
ЕстьЕсть, срок впередиНетСоздать задачу заново
ЕстьЕсть, срок прошёлЛюбаяУдалить роль идемпотентно
ЕстьНетНетНе снимать автоматически; отправить на разбор
НетЕстьЛюбаяЗакрыть assignment как уже снятый
НетНетНетСостояние согласовано

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

Срок хранится вне процесса

{
  "assignment_id": "rolegrant_01J...",
  "guild_id": "guild_ref",
  "member_id": "member_ref",
  "role_id": "role_ref",
  "granted_at": "2026-10-03T06:00:00Z",
  "expires_at": "2026-10-03T18:00:00Z",
  "status": "active",
  "version": 3
}

Храните абсолютный UTC-момент, а не «осталось 12 часов». После простоя expires_at можно сравнить с текущим временем. version или compare-and-set защищает запись, если продление роли и worker удаления пришли одновременно. Названия участников и причины доступа в техническую очередь не нужны.

Запуск бота начинается с reconciliation

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

  • Один assignment_id соответствует одному логическому сроку.
  • Создание задачи использует assignment_id как ключ дедупликации.
  • Удаление роли повторяемо: отсутствие роли считается завершённым результатом.
  • Ответ 429 обрабатывается по rate-limit headers, а не циклом без паузы.
  • Недоступный участник переводится в отдельный конечный статус, а не retry навсегда.

Gateway event обновляет факт, но не заменяет хранилище

Guild Member Update сообщает об изменении ролей участника. Событие помогает быстро заметить ручное снятие или выдачу, однако после разрыва соединения нельзя считать локальный кеш полным. При старте и перед опасным действием читайте актуальный Guild Member либо используйте библиотечный cache с понятной политикой заполнения.

Для получения member events и списков участников могут требоваться соответствующие Gateway Intents. Если intent отключён, отсутствие события не доказывает отсутствие изменения. Основной источник истины для конкретной проверки — ответ API Discord.

Стартовая очистка не должна снимать все роли

Опасный антишаблон — при запуске пройти по участникам и удалить role ID у тех, кого нет в памяти. После пустого кеша такой код снимает легитимные назначения. Стартовая процедура сначала загружает сохранённые assignments, затем читает фактическое состояние и изменяет только записи с доказанным происхождением.

Тест включает падение в неудобный момент

  1. Выдать тестовую роль на десять минут и подтвердить её в Guild Member.
  2. Перезапустить процесс до истечения и увидеть восстановленную задачу.
  3. Остановить процесс на момент истечения, затем запустить и снять роль один раз.
  4. Продлить роль одновременно со старой задачей и сохранить новое expires_at.
  5. Снять роль вручную и закрыть assignment по событию или сверке.
  6. Получить временный ответ API и выполнить retry без второй записи.

Для расследования нужны идентификаторы и переходы

Соберите assignment_id, обезличенные guild/member/role references, expires_at, status transitions, shard и результат Discord API. Bot token, полные профили участников и содержимое каналов не требуются. По этой последовательности видно, потерялся таймер, запись или роль была снята отдельным действием.

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