Cara mengatasi Express cookie tidak terbaca paling cepat adalah memastikan cookie-parser terpasang sebelum route, lalu cek req.headers.cookie. Kalau header ada tapi req.cookies kosong, masalahnya ada di parsing. Kalau header tidak ada sama sekali, browser tidak mengirim cookie karena opsi path, sameSite, secure, atau credentials salah.
Penyebab Express Cookie Tidak Terbaca
Express tidak mem-parse cookie secara bawaan. Objek req.cookies hanya tersedia setelah middleware cookie-parser berjalan.
app.use(cookieParser())dipasang setelah route, sehinggareq.cookiesmasih kosong saat dibaca.- Nama cookie salah ketik,
pathtidak cocok, atau cookie sudah kedaluwarsa. - Opsi
sameSite: 'strict'atausecure: truemembuat browser menahan cookie, terutama saat development memakai HTTP. - Request lintas origin dikirim tanpa
credentials: 'include'dan CORS server tidak mengizinkan kredensial.
Tabel Diagnosis req.cookies Kosong
Buka DevTools lalu periksa tab Application lalu Cookies. Bandingkan dengan log console.log(req.headers.cookie) di Express. Hasilnya menentukan sumber error.
| Masalah | Penyebab | Solusi |
|---|---|---|
req.cookies undefined |
cookie-parser belum dipakai | Pasang sebelum route |
| Header cookie undefined | Browser tidak mengirim | Cek path dan expiry |
| Cookie hilang di HTTP | secure: true |
Set false di lokal |
| Cookie hilang cross-origin | Tanpa credentials | Aktifkan include dan CORS |
| Signed cookie terbaca kosong | Secret berubah | Samakan secret parser |
Cookie terkirim tapi tidak ter-parse berarti perbaiki middleware. Cookie tidak terkirim berarti perbaiki browser, opsi res.cookie, atau CORS.
Langkah Memperbaiki Cookie Express yang Tidak Terbaca
- Pasang
cookie-parserpaling atas, sebelum semua route yang memakaireq.cookies. Cetak nilainya untuk memastikan middleware berjalan. - Perbaiki opsi saat set cookie. Gunakan
path: '/'agar terbaca semua route, aturmaxAgeyang cukup, dan pakaisameSite: 'lax'untuk kebutuhan login biasa. - Betulkan sisi frontend. Fetch butuh
credentials: 'include', axios butuhwithCredentials: true. Tanpa itu browser tidak mengirim cookie. - Selaraskan CORS dan signed cookie. Aktifkan
credentials: truedenganoriginspesifik, bukan*. Kalau memakai signed cookie, secret di parser harus sama dengan secret saat membuat cookie.
const express = require('express');
const cookieParser = require('cookie-parser');
const app = express();
app.use(cookieParser(process.env.COOKIE_SECRET));
app.get('/set', (req, res) => {
res.cookie('token', 'nilai-contoh', {
httpOnly: true,
path: '/',
maxAge: 60 * 60 * 1000,
sameSite: 'lax',
secure: process.env.NODE_ENV === 'production'
});
res.json({ ok: true });
});
app.get('/baca', (req, res) => {
console.log(req.headers.cookie);
res.json({ cookies: req.cookies });
});
app.listen(3000);
FAQ
Kenapa req.cookies undefined padahal cookie-parser sudah dipasang?
Urutan middleware salah. Pindahkan app.use(cookieParser()) ke atas sebelum route.
Kenapa cookie terbaca di Postman tapi tidak di browser?
Postman mengabaikan aturan secure dan sameSite. Browser memblokirnya kalau opsi tersebut tidak sesuai konteks HTTP atau cross-origin.
Apakah cookie httpOnly bisa dibaca di Express?
Bisa. httpOnly hanya memblokir JavaScript browser, Express tetap menerima cookie tersebut lewat header request.