Langsung ke konten

Login akun Yave Anda di perangkat ini akan berakhir, sehingga layanan Yave lain yang Anda gunakan di perangkat ini juga ikut keluar.

SPA 404 saat di-refresh? Satu pengaturan menyelesaikannya

Terakhir diperbarui: 2026-11-11

Daftar isi · 6
  1. 1. Unggah folder hasil build
  2. 2. Pastikan opsi SPA sudah aktif
  3. 3. Uji dengan tautan langsung dan refresh
  4. 4. Pakai halaman 404 juga? Pilih salah satu
  5. Pertanyaan umum
  6. Baca selanjutnya

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. 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. 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.

    Tab Situs di Pengaturan situs pada editor: bahasa situs, warna tema, halaman untuk alamat yang tidak ada, dan saat Selengkapnya dibuka terlihat instal aplikasi serta tombol untuk membuka halaman utama pada alamat yang tidak ada
    Pengaturan situs > Situs > Selengkapnya berisi tombol SPA
  3. 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 Terbit

    Dengan tombol aktif, me-refresh alamat ini membuka aplikasi Anda

  4. 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 > Situs
    Halaman untuk alamat yang tidak ada Halaman 404 bawaan
    Buka 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.

Mencoba lebih cepat daripada membaca — tempel HTML Anda dan terbitkan sekarang.

Mencari situs di ruang kerja saat ini. Untuk berganti ruang kerja, gunakan bagian atas bilah samping.