Error Express cannot set headers after sent muncul karena kode mengirim respons dua kali untuk satu request. Perbaikan tercepat: tambah return setelah setiap res.send, res.json, res.status().send(), atau res.redirect() agar eksekusi berhenti dan baris di bawahnya tidak ikut mengirim respons.
Penyebab Umum Cannot Set Headers After Sent di Express
Express hanya mengizinkan satu respons per request. Pengiriman kedua memicu error karena header HTTP sudah terkunci.
- Return hilang setelah res.send atau res.json, lalu kode di bawah tetap berjalan dan mengirim lagi.
- Kondisi if tanpa else, respons dikirim di dalam if lalu dikirim lagi di luar blok.
- next() dipanggil setelah respons terkirim, sehingga middleware berikut ikut membalas request yang sama.
- Callback async berjalan dua kali, misalnya callback database plus fallback timeout sama-sama memanggil res.json.
- Dua middleware atau dua route cocok menangani path yang sama dan keduanya mengirim respons.
Tabel Diagnosis Cepat Berdasarkan Pesan Error
Baca stack trace Node.js. Baris kedua yang disebut biasanya pengirim ganda, bukan penyebab utama.
| Masalah | Pemicu | Cek Cepat |
|---|---|---|
| Balas di if lalu balas lagi | Tidak ada return atau else | Cari dua res.json dalam satu handler |
| Middleware ikut membalas | next setelah res.send | Cek urutan app.use dan route |
| Callback async ganda | Timeout dan query sama balas | Tambah flag sudah dibalas |
Cara Memperbaiki dengan Return dan Satu Jalur Respons
Pastikan setiap request hanya melewati satu perintah pengiriman respons.
- Tambah return setelah tiap respons. Berlaku untuk send, json, status, redirect, dan end.
- Rapikan percabangan. Gunakan if return else agar hanya satu cabang yang mengirim. Panggil next(err) hanya bila belum ada respons.
- Amankan handler async dengan try catch. Lempar error ke middleware error Express, jangan balas langsung dari dua tempat.
const express = require('express');
const app = express();
app.use(express.json());
app.get('/user/:id', async (req, res, next) => {
try {
if (!req.params.id) {
return res.status(400).json({ error: 'id wajib diisi' });
}
if (req.params.id === '0') {
return res.status(404).json({ error: 'user tidak ditemukan' });
}
return res.json({ id: req.params.id });
} catch (err) {
next(err);
}
});
app.use((err, req, res, next) => {
if (res.headersSent) {
return next(err);
}
res.status(500).json({ error: 'terjadi kesalahan server' });
});
module.exports = app;
FAQ
Kenapa return wajib setelah res.send?
Karena res.send tidak menghentikan fungsi, jadi kode sesudahnya tetap berjalan tanpa return.
Apakah next() boleh setelah res.json?
Tidak, kecuali middleware berikutnya tidak mengirim respons dan tidak memanggil error handler yang membalas.
Dari mana tahu baris pengirim kedua?
Lihat stack trace ERR_HTTP_HEADERS_SENT, baris yang ditunjuk biasanya percobaan pengiriman kedua.