Penyebab ERR_TOO_MANY_Redirects dan Cara Mengatasi Express Redirect Loop

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() setelah res.redirect() sehingga handler berikut mengirim redirect lagi.
  • Guard login memantulkan: /dashboard melempar ke /login, lalu /login melempar balik karena sesi belum terbaca.
  • Normalisasi URL ganda, misalnya slash ganda atau /profil/ selalu diarahkan ke /profil tanpa pengecualian.
  • Cek protokol salah di balik proxy: aplikasi menerima HTTP dari Nginx, lalu memaksa HTTPS berulang kali karena req.secure selalu 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

  1. Reproduksi loop:
    curl -I -L --max-redirs 10 http://localhost:3000/dashboard

    Catat nilai Location yang berulang.

  2. Temukan middleware terakhir yang mengirim redirect. Tambahkan log path dan status login sebelum res.redirect.
  3. Perbaiki urutan middleware. Parser cookie, session, dan Passport harus dipasang sebelum guard auth.
  4. Aktifkan trust proxy hanya bila Express memang berjalan di balik Nginx atau load balancer.
  5. Pilih status redirect sesuai kebutuhan dan validasi nilai req.query.next agar 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.