Cara mengatasi express static file tidak muncul paling cepat adalah memperbaiki path folder ke absolut dengan path.join(__dirname, “public”) lalu memastikan app.use(express.static(…)) terpasang sebelum route. Sebagian besar kasus 404 CSS, JS, atau gambar bukan karena file hilang, melainkan Express mencari di folder yang salah atau middleware tidak sempat jalan.
Penyebab Express Static File Tidak Muncul
Express tidak menebak lokasi folder. Ia membaca path persis seperti yang kamu tulis saat server dijalankan.
- Path relatif seperti express.static(“public”) pecah ketika kamu menjalankan server dari folder berbeda.
- Middleware static belum didaftarkan, atau tertulis sesudah route 404 sehingga request tidak pernah sampai ke file.
- Nama file beda huruf besar kecil, contoh Style.css dipanggil sebagai style.css, gagal di Linux.
- Prefix URL tidak cocok, contoh server memakai /static tapi HTML memanggil /css/style.css.
- Browser menyajikan CSS lama dari cache, atau proses Node tidak punya izin baca folder public.
Tabel Diagnosis Cepat File Static 404
Buka DevTools, tab Network, lalu refresh halaman. Klik file yang merah dan lihat statusnya.
| Masalah | Penyebab | Solusi |
|---|---|---|
| Semua aset 404 | Path folder salah | Ganti ke path.join dan __dirname |
| Satu file 404 | Salah nama atau prefix URL | Samakan nama file dan src di HTML |
| File ketemu tapi tampilan lama | Cache browser | Hard refresh dengan Ctrl+Shift+R |
Bedakan responsnya. 404 dengan pesan Express berarti middleware static tidak menangani request itu. Status 200 tapi file kosong atau CSS tidak berpengaruh biasanya berarti URL menemukan file lain atau browser memakai cache.
Cara Memperbaiki Express Static yang 404
- Cek struktur folder. Pastikan server.js dan folder public berada di posisi yang kamu kira.
- Perbaiki path ke bentuk absolut agar tidak tergantung direktori kerja.
- Pasang middleware static sebelum semua route halaman dan API.
- Tes URL aset langsung di browser, contoh http://localhost:3000/css/style.css.
- Lakukan hard refresh agar CSS baru benar-benar dimuat.
const path = require("path");
const express = require("express");
const app = express();
app.use(express.static(path.join(__dirname, "public")));
app.get("/", (req, res) => {
res.sendFile(path.join(__dirname, "views", "index.html"));
});
app.listen(3000);
Untuk ES Module dengan “type”: “module” di package.json, __dirname tidak tersedia. Buat sendiri dari import.meta.url memakai fileURLToPath, lalu gunakan path.join seperti biasa. Validasi akhir bisa memakai curl http://localhost:3000/css/style.css. Jika isi CSS tampil di terminal, masalahnya tinggal di HTML atau cache.
FAQ
Kenapa file ada tapi tetap 404 di browser?
Express mencarinya di folder lain karena path relatif, atau URL yang diminta tidak cocok dengan prefix static.
Apakah express.static harus dipasang sebelum route?
Ya, pasang sebelum route halaman dan sebelum handler 404 agar request aset sempat dilayani.
Kenapa CSS berubah tapi tampilan tidak update?
Browser masih memakai salinan lama, lakukan hard refresh atau tambah query versi seperti style.css?v=2.