Stop Respons Terkirim Dua Kali dengan Cara Mengatasi Express Response Headers Sent

Error Cannot set headers after they are sent to the client berarti kode kamu memanggil respons Express dua kali dalam satu request. Cara mengatasi express response headers sent paling cepat: tambahkan return setelah setiap res.send(), res.json(), atau res.redirect() agar eksekusi berhenti dan tidak jatuh ke respons kedua.

Penyebab Umum Headers Already Sent di Express

Express hanya mengizinkan satu respons per request. Setelah header terkirim, pemanggilan kedua langsung melempar error.

  • Middleware memanggil next() setelah res.send() atau res.json(), sehingga handler berikutnya mengirim respons lagi.
  • Blok if tanpa return membuat kode lanjut ke bawah dan mengeksekusi res.json() kedua.
  • Callback async, forEach, atau loop memanggil res berkali-kali untuk banyak item atau banyak hasil query.

Tabel Diagnosis Cepat Error Headers Sent

Masalah Penyebab Solusi
Double send next() setelah res.send Hapus next() atau beri return
Missing return if tanpa return Gunakan return res.json()
Async callback res di dalam loop Kumpulkan data, kirim sekali

Baca stack trace dari atas ke bawah. Cari baris at app.js atau at router yang menunjuk ke pemanggilan res kedua. Itu lokasi yang harus diberi guard. Bedakan sumbernya: route mengirim body, middleware mengatur auth atau validasi, error handling mengirim status 500.

Perbaiki Double Response dengan Return dan Guard

Lakukan perbaikan berikut pada route dan middleware yang bermasalah:

  1. Hentikan eksekusi tepat setelah respons terkirim dengan return res.send(), return res.json(), atau return res.redirect().
  2. Ubah percabangan menjadi if-else agar hanya satu jalur yang mengirim respons.
  3. Untuk middleware async, bungkus dengan try/catch dan teruskan error ke next(err) tanpa mengirim respons ganda.
  4. Pastikan hanya satu titik respons untuk alur sukses dan satu titik untuk alur error.
app.get('/user/:id', async (req, res, next) => {
  try {
    if (!req.params.id) {
      return res.status(400).json({ error: 'id wajib diisi' });
    }
    const user = await getUserById(req.params.id);
    if (!user) {
      return res.status(404).json({ error: 'user tidak ditemukan' });
    }
    return res.json(user);
  } catch (err) {
    next(err);
  }
});

FAQ

Kenapa return wajib setelah res.json di Express?

Karena res.json tidak menghentikan fungsi, return mencegah kode di bawahnya mengirim respons kedua.

Apakah boleh memanggil next() setelah mengirim respons?

Tidak, next() akan menjalankan middleware berikutnya yang bisa mengirim respons lagi.

Bagaimana mencegah headers sent pada kode async?

Gunakan try/catch, kirim respons satu kali di akhir, dan lempar error ke middleware error handler.