После переустановки нельзя продолжать использовать сохранённый ранее token «пока он работает». OAuth callback возвращает актуальную установку; её нужно атомарно записать по правильному workspace/enterprise ключу и заставить workers перечитать версию. Ошибка часто находится не в Slack, а в кэше или записи, которую callback добавил вместо обновления.

Сразу разделите bot token и user token. В ответе `oauth.v2.access` bot access token находится на верхнем уровне, а пользовательский — внутри `authed_user`. Если worker вызывает метод от имени bot, подстановка user token после изменения схемы даст другой набор scopes или отказ.

Сверьте четыре идентификатора установки

Поле OAuth responseДля чего хранитьТипичная ошибка
app_idОтличить production и staging appToken записан под другим приложением
team.idКлюч workspace installationСоздана вторая строка по team name
enterprise.idУчесть org-wide установкуWorkspace lookup не находит enterprise install
bot_user_idПроверить identity ботаWorker ожидает старого bot user
scopeПроверить доступный набор методовКод ожидает невыданный scope
authed_user.idСвязать user token с пользователемUser token принят за bot token

Названия workspace и enterprise могут меняться и не подходят как ключ. Секретное значение token не печатайте для сравнения; используйте внутренний version ID, последние четыре символа только в закрытой диагностике или безопасный fingerprint по принятой процедуре.

OAuth callback делает атомарный upsert

BEGIN;

SELECT version FROM slack_installations
WHERE app_id = :app_id
  AND team_id <=> :team_id
  AND enterprise_id <=> :enterprise_id
FOR UPDATE;

-- Зашифровать новые bot/user tokens и заменить scopes, bot_user_id, installed_at.
-- Увеличить version, но не удалять рабочую запись до успешного oauth.v2.access.

COMMIT;
PUBLISH installation_changed(app_id, team_id, enterprise_id, version);

Транзакция не должна включать сетевой вызов Slack. Сначала обменяйте временный code через `oauth.v2.access`, проверьте `ok`, `app_id` и ожидаемый state, затем зафиксируйте результат. Authorization code короткоживущий и одноразовый, поэтому повтор callback не должен затирать хорошую запись пустыми полями.

Кэш переключается по версии

Если API использует Redis или память процесса, обновление SQL само по себе не меняет активный credential. Добавьте installation version и инвалидируйте cache после commit. Worker перед долгой серией задач может перечитать запись при `invalid_auth`, но не должен бесконечно повторять запрос с тем же token.

  • Логируйте team ID, app ID, installation version и Slack error, но не bearer token.
  • При `missing_scope` сравнивайте granted scopes последней установки с требованием метода.
  • При `invalid_auth` остановите retry storm и один раз перечитайте installation.
  • Разделяйте production и staging credentials по app_id.
  • Не удаляйте старую рабочую запись, если новый OAuth exchange завершился ошибкой.

Token rotation меняет модель хранения

Если включена Slack token rotation, access token имеет срок, а refresh token используется для получения следующей пары. Slack указывает, что refresh token одноразовый и после короткого grace period отзывается. Обновление access и refresh token должно быть атомарным, иначе два параллельных refresher потеряют актуальную пару.

Поставьте блокировку на одну installation, обновляйте credential до `expires_in`, сохраняйте новое значение только после успешного ответа и ограничьте число активных workers. Не смешивайте reinstall и refresh: reinstall проходит authorization code flow, а refresh использует `grant_type=refresh_token`.

Переустановка проверяется реальным методом

В тестовом workspace установите приложение, выполните простой метод с bot token, затем измените scopes и переустановите. Убедитесь, что installation version выросла, старый cache очищен, а worker использует новые scopes. После этого удалите приложение и проверьте, что ревокация приводит к понятному состоянию `reauthorization_required`, а не к бесконечным retries.

Для совместного разбора нужны обезличенный OAuth response без token, ключ installation, версия записи, список scopes и точная Slack error. Client secret, signing secret, access и refresh tokens передавать нельзя.

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