Цикл появляется, когда условие после перехода остаётся истинным. Гость на `/account` отправляется на `/login`, но тот же Middleware считает `/login` защищённым и снова отправляет на `/login`. Другой вариант: приложение видит HTTP за прокси и бесконечно перенаправляет на HTTPS, хотя внешний запрос уже HTTPS.

Не очищайте cookies наугад и не убирайте авторизацию целиком. Сначала запросите проблемный URL с отключённым автоматическим follow. Последовательность `status + Location + Set-Cookie` показывает, какое правило создало следующее ребро.

Цепочка редиректов читается как журнал решений

ШагВходРешениеLocation/состояние
1/accountнет session/login?next=/account
2/loginмаршрут ошибочно protected/login?next=/login
3/login?next=/loginусловие всё ещё истинноцикл подтверждён
Норма/loginpublic routeNextResponse.next()
После входа/loginsession есть/account или dashboard

В журнале полезны route class, authenticated, redirect target и request id. Не записывайте значение session cookie или токен. Если Location чередует два host либо http/https, добавьте в снимок `Host`, `X-Forwarded-Host` и `X-Forwarded-Proto` на доверенной границе.

Публичная цель исключается до проверки сессии

import { NextResponse } from 'next/server'

const publicRoutes = new Set(['/login', '/signup'])

export function middleware(request) {
  const path = request.nextUrl.pathname
  const session = request.cookies.get('session')?.value

  if (publicRoutes.has(path)) {
    if (session && path === '/login') {
      return NextResponse.redirect(new URL('/account', request.url))
    }
    return NextResponse.next()
  }

  if (path.startsWith('/account') && !session) {
    const target = new URL('/login', request.url)
    target.searchParams.set('next', path)
    return NextResponse.redirect(target)
  }

  return NextResponse.next()
}

Пример условный: проверка подлинности сессии зависит от библиотеки. Существенная часть — публичный маршрут имеет явный выход, а целевой URL не совпадает с текущим. Параметр `next` принимают только как внутренний допустимый путь, иначе получится open redirect.

Matcher сокращает поверхность запуска

Matcher должен пропускать framework assets, изображения и API, которые не участвуют в навигации. Аутентификацию нельзя считать завершённой только потому, что Middleware пропустил запрос: Next.js рекомендует выполнять основную проверку прав ближе к данным. Middleware/Proxy удобен для раннего redirect, но не заменяет Data Access Layer.

  • Исключите `_next/static`, `_next/image`, favicon и публичные файлы.
  • Решите отдельно, должен ли matcher охватывать route handlers API.
  • Не применяйте locale redirect к URL, где locale уже присутствует.
  • Не переписывайте `/login` на страницу, которая снова требует login.
  • Не доверяйте forwarded headers от произвольного клиента; нормализуйте их на proxy.

Cookie записывается в возвращаемый response

const response = NextResponse.redirect(new URL('/account', request.url))
response.cookies.set('onboarding', 'done', {
  httpOnly: true,
  sameSite: 'lax',
  secure: true,
  path: '/',
})
return response

Если создать response, записать в него cookie, а затем вернуть новый `NextResponse.redirect`, заголовок Set-Cookie потеряется. На следующем запросе условие снова увидит старое состояние. Проверьте Domain, Path, Secure и SameSite в реальном HTTPS-окружении; не ослабляйте их только ради прекращения цикла.

Reverse proxy может создавать второй круг

НаблюдениеВероятная причинаПроверка
http ↔ httpsПриложение не видит внешний protoTrusted proxy и X-Forwarded-Proto
www ↔ без wwwДва слоя канонизации спорятCDN, nginx и Next config
/login ↔ /accountДве ветки authSession decode и public routes
/ru ↔ /Locale default/детекторpathname и сохранённый locale
Только после входаCookie не сохранилась/не прочиталасьSet-Cookie и следующий Cookie

Регрессия проходит четыре состояния

  1. Гость открывает protected URL и получает один переход на login.
  2. Гость открывает login напрямую и остаётся на странице.
  3. Авторизованный открывает login и один раз попадает в account.
  4. Авторизованный открывает protected URL без redirect.
  5. Assets и изображения возвращаются без участия auth-правила.
  6. Те же сценарии повторяются через production proxy по HTTPS.

Исправление принято, когда redirect graph не содержит цикла, количество переходов заранее объяснимо, cookie видна в следующем request, а доступ к данным проверяется независимо от Middleware. Для разбора нужны matcher, predicates, обезличенная цепочка заголовков и схема CDN/proxy.

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