ERR_TOO_MANY_REDIRECTS di Express hampir selalu berarti dua route atau middleware saling memantulkan request. Browser berhenti setelah sekitar 20 kali pantulan. Periksa header Location dengan curl, lalu hentikan rantai redirect di middleware yang salah urutan.
Penyebab Umum Redirect Berputar di Express
Express mengeksekusi middleware berurutan. Satu kondisi yang tidak pernah terpenuhi membuat request berputar di tempat yang sama.
- Memanggil
next()setelahres.redirect()sehingga handler berikut mengirim redirect lagi. - Guard login memantulkan:
/dashboardmelempar ke/login, lalu/loginmelempar balik karena sesi belum terbaca. - Normalisasi URL ganda, misalnya slash ganda atau
/profil/selalu diarahkan ke/profiltanpa pengecualian. - Cek protokol salah di balik proxy: aplikasi menerima HTTP dari Nginx, lalu memaksa HTTPS berulang kali karena
req.secureselalu false.
| Gejala | Penyebab | Verifikasi cepat |
|---|---|---|
| Loop hanya setelah login | Guard auth membaca cookie atau sesi yang belum ada | Cek cookie di DevTools dan log req.session |
| Loop HTTP ke HTTPS | Proxy belum dipercaya | Log req.protocol dan header x-forwarded-proto |
| Loop antar dua path | Aturan redirect bertabrakan | Jalankan curl dan baca rantai Location |
Cara Memperbaiki Redirect Loop Langkah per Langkah
- Reproduksi loop:
curl -I -L --max-redirs 10 http://localhost:3000/dashboardCatat nilai
Locationyang berulang. - Temukan middleware terakhir yang mengirim redirect. Tambahkan log path dan status login sebelum
res.redirect. - Perbaiki urutan middleware. Parser cookie, session, dan Passport harus dipasang sebelum guard auth.
- Aktifkan
trust proxyhanya bila Express memang berjalan di balik Nginx atau load balancer. - Pilih status redirect sesuai kebutuhan dan validasi nilai
req.query.nextagar tidak mengarah ke dirinya sendiri.
app.use(express.urlencoded({ extended: false }));
function requireLogin(req, res, next) {
if (req.session && req.session.userId) {
return next();
}
return res.redirect(302, '/login');
}
app.get('/dashboard', requireLogin, (req, res) => {
res.send('Dashboard');
});
Gunakan 302 untuk redirect sementara seperti login. Pakai 301 hanya untuk URL pindah permanen karena browser menyimpannya dalam cache. Pakai 307 bila method dan body POST harus dipertahankan.
FAQ
Kenapa ERR_TOO_MANY_REDIRECTS hanya terjadi saat login?
Sesi belum tersimpan saat guard pertama berjalan, sehingga halaman tujuan menganggap pengguna belum login.
Apakah trust proxy aman diaktifkan di Express?
Aman bila server hanya menerima request dari reverse proxy tepercaya, atur dengan app.set('trust proxy', 1) dan jangan aktifkan untuk koneksi langsung.
Kapan memakai 301 dan kapan 302?
Pakai 301 untuk perpindahan URL permanen, pakai 302 untuk alur sementara seperti auth dan form.