После переустановки нельзя продолжать использовать сохранённый ранее 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 app | Token записан под другим приложением |
| 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 передавать нельзя.