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:
- Hentikan eksekusi tepat setelah respons terkirim dengan return res.send(), return res.json(), atau return res.redirect().
- Ubah percabangan menjadi if-else agar hanya satu jalur yang mengirim respons.
- Untuk middleware async, bungkus dengan try/catch dan teruskan error ke next(err) tanpa mengirim respons ganda.
- 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.