Cara mengatasi express cors error paling cepat adalah memasang middleware cors sebelum semua route, lalu mengisi origin dengan domain frontend yang persis sama. Kesalahan yang paling sering terlewat adalah urutan middleware yang salah dan memakai origin: "*" bersama credentials: true.
Browser memblokir respons bukan karena Express rusak, melainkan karena header Access-Control-Allow-Origin tidak cocok. Postman tetap jalan karena Postman tidak menerapkan kebijakan CORS.
Penyebab Umum Express CORS Error
CORS adalah aturan browser, bukan aturan Express. Server tetap mengirim respons, tetapi browser membuangnya bila header izin tidak valid.
- Origin frontend tidak terdaftar di backend, misalnya beda port atau protokol.
- Middleware
cors()dipasang setelah route sehingga tidak ikut jalan. - Preflight
OPTIONStidak dijawab dengan header izin. credentials: truedipadukan dengan wildcard*, kombinasi ini selalu ditolak browser.- Header custom seperti
Authorizationtidak didaftarkan diallowedHeaders.
Tabel Diagnosis Cepat CORS Error
Buka DevTools, tab Network, klik request yang gagal, lalu periksa tab Headers dan Console.
| Masalah | Pesan di Browser | Perbaikan |
|---|---|---|
| Tanpa header CORS | blocked by CORS policy | Pasang cors sebelum route |
| Preflight gagal | preflight 404 | Izinkan method OPTIONS |
| Kredensial ditolak | credentials mode is include | Ganti * dengan origin spesifik |
- Periksa
access-control-allow-originpada response header. - Periksa
access-control-allow-methodsuntuk PUT, PATCH, DELETE. - Periksa
access-control-allow-credentialsbila memakai cookie.
Cara Memperbaiki CORS di Express
- Pasang paket resmi:
npm install cors. - Pasang middleware CORS sebelum route dan body parser.
- Isi origin spesifik dari environment variable, jangan hardcode domain production.
- Aktifkan credentials hanya bila frontend mengirim cookie atau Authorization.
- Uji memakai
fetchdari origin asli, bukan hanya Postman.
// CommonJS
const express = require('express');
const cors = require('cors');
const app = express();
app.use(cors({
origin: process.env.FRONTEND_URL,
credentials: true
}));
app.use(express.json());
// ES Module
import express from 'express';
import cors from 'cors';
const app = express();
app.use(cors({
origin: process.env.FRONTEND_URL,
credentials: true
}));
app.use(express.json());
FAQ
Kenapa API jalan di Postman tapi error di browser?
Postman tidak menerapkan CORS, sedangkan browser mewajibkan header izin sebelum membaca respons.
Apakah app.use cors tanpa origin aman untuk production?
Tidak aman untuk API privat karena semua situs bisa memanggilnya, batasi ke domain tertentu.
Kenapa cookie tidak terkirim walau CORS sudah aktif?
Aktifkan credentials: true di Express dan credentials: include di fetch, lalu hindari origin wildcard.