Цикл появляется, когда условие после перехода остаётся истинным. Гость на `/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 | условие всё ещё истинно | цикл подтверждён |
| Норма | /login | public route | NextResponse.next() |
| После входа | /login | session есть | /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 | Приложение не видит внешний proto | Trusted proxy и X-Forwarded-Proto |
| www ↔ без www | Два слоя канонизации спорят | CDN, nginx и Next config |
| /login ↔ /account | Две ветки auth | Session decode и public routes |
| /ru ↔ / | Locale default/детектор | pathname и сохранённый locale |
| Только после входа | Cookie не сохранилась/не прочиталась | Set-Cookie и следующий Cookie |
Регрессия проходит четыре состояния
- Гость открывает protected URL и получает один переход на login.
- Гость открывает login напрямую и остаётся на странице.
- Авторизованный открывает login и один раз попадает в account.
- Авторизованный открывает protected URL без redirect.
- Assets и изображения возвращаются без участия auth-правила.
- Те же сценарии повторяются через production proxy по HTTPS.
Исправление принято, когда redirect graph не содержит цикла, количество переходов заранее объяснимо, cookie видна в следующем request, а доступ к данным проверяется независимо от Middleware. Для разбора нужны matcher, predicates, обезличенная цепочка заголовков и схема CDN/proxy.