Ошибка `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/callbackhttps://app.example.ru/callbackНе совпадает схема
https://app.example.ru/callback/https://app.example.ru/callbackЛишний slash
https://app.example.ru/oauth/callbackhttps://app.example.ru/callbackДругой path
https://app.example.ru:8443/cbhttps://app.example.ru/cbДругой порт
https://stage.example.ru/cbhttps://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` не нужны.

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