SPA 404 saat di-refresh? Satu pengaturan menyelesaikannya
Terakhir diperbarui: 2026-11-11
Singkatnya: di Pengaturan situs > Situs, buka Selengkapnya lalu aktifkan “Buka halaman utama untuk alamat yang tidak ada (situs bergaya aplikasi)”; tautan langsung dan refresh pada situs React atau Vue akan membuka aplikasi Anda, bukan 404. Catatan: saat opsi ini aktif, “Halaman untuk alamat yang tidak ada” tidak dipakai untuk alamat biasa, jadi pilih yang cocok dengan situs Anda.
Sekilas
- Waktu yang dibutuhkan
- Sekitar 2 menit
- Paket yang dibutuhkan
- Gratis
- Pengetahuan kode
- Tidak perlu
- Tempat melakukannya
- Editor
Langkah demi langkah
- 1
Unggah folder hasil build
Untuk situs React, Vue, atau Vite, unggah folder hasil perintah build (biasanya dist), dalam bentuk ZIP atau folder. Situs seperti ini membawa index.html yang hampir kosong dan sebuah skrip yang menggambar tampilannya. Karena itu tidak ada file untuk alamat seperti /about, dan saat opsi mati, membuka alamat itu langsung atau me-refresh-nya menghasilkan 404.
index.html<!doctype html><div id="root"></div><script type="module" src="/assets/index.js"></script> - 2
Pastikan opsi SPA sudah aktif
Tepat setelah impor lewat ZIP, folder, atau GitHub, jika file Anda jelas berstruktur aplikasi seperti ini, opsi menyala sendiri dan editor memberi tahu Anda. Untuk memeriksa sendiri, buka Setelan > Pengaturan situs > Situs di menu kiri, buka Selengkapnya, lalu aktifkan “Buka halaman utama untuk alamat yang tidak ada (situs bergaya aplikasi)”. Perubahan tersimpan otomatis dan langsung berlaku tanpa menerbitkan ulang.
Pengaturan situs > Situs > Selengkapnya berisi tombol SPA - 3
Uji dengan tautan langsung dan refresh
Buka alamat Anda dengan salah satu rute aplikasi di ujungnya, lalu refresh. Kalau yang muncul aplikasi Anda, bukan 404, berarti beres. Hanya alamat layar (tanpa ekstensi) yang membuka halaman utama; file berekstensi seperti gambar atau skrip yang tidak ada tetap menghasilkan 404.
myname.html2site.com/about TerbitDengan tombol aktif, me-refresh alamat ini membuka aplikasi Anda
- 4
Pakai halaman 404 juga? Pilih salah satu
“Halaman untuk alamat yang tidak ada” dipilih di Pengaturan situs > Situs dari halaman-halaman di situs ini (jika tidak dipilih, halaman 404 bawaan yang tampil). Itu pilihan yang tepat untuk situs biasa berhalaman banyak, dengan tombol SPA dimatikan. Saat tombol aktif, alamat yang tidak dikenal membuka halaman utama sehingga halaman 404 itu tidak dipakai. Jika ingin layar “tidak ditemukan” di dalam aplikasi, buat di router aplikasi Anda.
Pengaturan situs > SitusHalaman untuk alamat yang tidak ada Halaman 404 bawaanBuka halaman utama untuk alamat yang tidak ada ON
Pertanyaan umum
Kenapa aplikasi React saya 404 saat di-refresh?
Aplikasi satu halaman tidak punya satu file per alamat; skrip di browser membaca alamat lalu menggambar tampilan. Hosting statis mencari file bernama sama dengan alamat, tidak menemukan apa pun untuk /about, lalu mengembalikan 404. Dengan opsi SPA aktif, alamat itu menyajikan halaman utama dan aplikasi Anda mengambil alih.
Apakah saya harus mengaktifkan opsi SPA sendiri?
Tepat setelah impor lewat ZIP, folder, atau GitHub, opsi aktif sendiri bila file Anda jelas berbentuk aplikasi (misalnya halaman utama kosong yang diisi skrip). Bila tandanya lebih lemah, Pengaturan situs menampilkan saran beserta alasannya di Selengkapnya. Dalam kedua kasus, Anda bisa menyalakan atau mematikannya lewat tombol.
Bolehkah dibiarkan aktif untuk situs biasa?
Tidak disarankan. Saat aktif, setiap alamat yang salah ketik membuka halaman utama, halaman 404 kustom Anda tidak pernah dipakai, dan mesin pencari bisa menganggap alamat yang tidak ada sebagai halaman asli. Situs yang punya file per halaman sebaiknya mematikannya.
Bisakah saya tetap menampilkan layar “halaman tidak ditemukan” di situs SPA?
Opsi ini mengarahkan alamat yang tidak dikenal ke halaman utama, jadi layar itu harus berasal dari router aplikasi Anda sendiri. Jika lebih suka halaman 404, matikan tombol lalu pilih halaman di “Halaman untuk alamat yang tidak ada”.
Sudah saya aktifkan tapi masih 404. Bagaimana?
Periksa dulu apakah daftar file punya halaman utama (index.html); tanpanya tidak ada yang bisa dibuka sehingga muncul 404. Selain itu, alamat berekstensi seperti .js atau .png memang mengembalikan 404 bila filenya tidak ada; pastikan path file yang dimuat aplikasi Anda sudah benar.
Baca selanjutnya
- Unggah folder situs sebagai ZIP dan dapatkan alamat sendiri Panduan menayangkan situs multi-file (CSS, JS, gambar, halaman lain) dari ZIP atau satu folder penuh di alamat Anda sendiri secara gratis (bahasa Indonesia)
- Impor repositori GitHub dan deploy sebagai situs statis Panduan mengimpor file statis dari repositori GitHub publik dan menerbitkannya gratis di alamat Anda: tanpa build, index.html wajib ada (bahasa Indonesia)
- Kembalikan situs yang sudah diterbitkan ke versi sebelumnya Cara mengembalikan situs yang sudah diterbitkan ke versi sebelumnya: tinjau, pulihkan, batalkan pemulihan, dan yang disimpan paket gratis serta Plus (Bahasa Indonesia)
- Cara menghubungkan domain sendiri ke situs Anda Panduan langkah demi langkah menghubungkan domain sendiri ke situs HTML yang diterbitkan: masukkan alamat, tambahkan nilai CNAME dan TXT di tempat membeli domain, tunggu Terhubung, HTTPS otomatis (mulai Plus)
Mencoba lebih cepat daripada membaca — tempel HTML Anda dan terbitkan sekarang.