Cara Mengatasi Express Cors Error dalam 4 Perbaikan Berurutan

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 OPTIONS tidak dijawab dengan header izin.
  • credentials: true dipadukan dengan wildcard *, kombinasi ini selalu ditolak browser.
  • Header custom seperti Authorization tidak didaftarkan di allowedHeaders.

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-origin pada response header.
  • Periksa access-control-allow-methods untuk PUT, PATCH, DELETE.
  • Periksa access-control-allow-credentials bila memakai cookie.

Cara Memperbaiki CORS di Express

  1. Pasang paket resmi: npm install cors.
  2. Pasang middleware CORS sebelum route dan body parser.
  3. Isi origin spesifik dari environment variable, jangan hardcode domain production.
  4. Aktifkan credentials hanya bila frontend mengirim cookie atau Authorization.
  5. Uji memakai fetch dari 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.