Ошибка `redirect_uri_mismatch` возникает до callback-кода: сервер авторизации сравнивает URI из запроса с URI, зарегистрированным для данного `client_id`. Скопируйте оба значения как текст и сравните схему, регистр host, порт, path и завершающий slash. Похожий адрес здесь не считается тем же адресом.
RFC 9700 требует exact string matching для заранее зарегистрированных redirect URI, кроме особого правила портов localhost у native apps. Нельзя лечить production web-клиент wildcard-путём или открытым redirect: это расширяет место, куда может утечь code или token.
Одна строка часто отличается одним символом
| Запрос | Зарегистрировано | Результат |
|---|---|---|
| http://app.example.ru/callback | https://app.example.ru/callback | Не совпадает схема |
| https://app.example.ru/callback/ | https://app.example.ru/callback | Лишний slash |
| https://app.example.ru/oauth/callback | https://app.example.ru/callback | Другой path |
| https://app.example.ru:8443/cb | https://app.example.ru/cb | Другой порт |
| https://stage.example.ru/cb | https://app.example.ru/cb | Другое окружение |
Сравнивайте уже URL-decoded значение параметра, но не нормализуйте его «для удобства». Authorization server обязан проверять фактическую строку. В Google OAuth несовпадение с authorized redirect URI выбранного client ID прямо приводит к `redirect_uri_mismatch`.
Источник URI ищем в первом запросе, а не в callback
GET /authorize?
response_type=code&
client_id=web-prod-client&
redirect_uri=https%3A%2F%2Fapp.example.ru%2Foauth%2Fcallback&
state=opaque-random-value&
code_challenge=...&code_challenge_method=S256
decoded redirect_uri:
https://app.example.ru/oauth/callbackПример условный и не содержит рабочего client ID. Возьмите значение из Network перед переходом к провайдеру или из безопасного server log с редактированием `state`, `code_challenge` и других чувствительных параметров. Ошибка на token endpoint — уже другой этап: там нужно убедиться, что передан тот же redirect URI, что был в authorization request.
Reverse proxy может собрать внешний адрес как внутренний
Приложение за TLS-терминатором иногда видит `http`, внутренний hostname или порт контейнера и строит callback из них. Установите явный публичный base URL либо корректно настройте доверие к forwarded headers только от своего proxy. Не доверяйте `X-Forwarded-Host` от произвольного клиента: иначе исправление создаст open redirect.
- Сверьте фактический Host и scheme, которые видит приложение после доверенного proxy.
- Проверьте, не добавляет ли framework slash по маршруту callback.
- Не собирайте redirect URI из заголовка Referer.
- Не принимайте callback destination из пользовательского query-параметра без allowlist.
- После изменения конфигурации проверьте authorization request до ввода учётных данных.
Каждому окружению — отдельная точная запись
Production, staging и локальная разработка получают отдельные URI; для чувствительных систем полезны и разные OAuth clients. Так тестовый callback не становится разрешённым назначением production-кода. Старый домен удаляйте из allowlist после завершения миграции и проверки активных пользователей.
Если провайдер ограничивает число URI, это не повод делать один redirector с параметром `next`. Такой сервис сам становится критическим authorization endpoint и обязан иметь строгую таблицу назначений, привязку к client и защиту state.
State и PKCE не исправляют неверный адрес
`state` связывает ответ с начатой браузерной сессией, а PKCE связывает authorization code с code verifier. Эти меры нужны, но они не заменяют точную регистрацию redirect URI. Не отключайте их, пытаясь убрать mismatch: ошибка возникает раньше и останется.
Приёмка проходит полный круг один раз
После исправления начните новый flow, убедитесь, что провайдер вернул code на ожидаемый HTTPS callback, приложение сверило state и token exchange завершился без повторного redirect. Старую вкладку не используйте: code и state одноразовые, а кешированный authorization URL может сохранить прежний адрес.
Для разбора подготовьте название провайдера, тип клиента, обезличенную строку authorization request, зарегистрированные URI и схему proxy. Client secret, authorization code, access token, cookies и настоящий `state` не нужны.