Dokumen publik yang tidak ditemukan seharusnya menampilkan penjelasan yang jelas dan mengembalikan status HTTP yang sesuai, biasanya 404. Di Mac, Anda dapat memeriksa keduanya di Chrome, mengidentifikasi ketidakcocokannya, dan memberikan koreksi yang tepat kepada sistem penerbitan Anda.

Alur kerja ini ditujukan bagi orang yang memelihara halaman dokumen publik: panduan, catatan referensi, atau lembar instruksi sederhana. Tujuannya adalah menyelaraskan alamat yang diminta, respons server, dan pesan yang ditampilkan. Semua contoh jalur di bawah ini bersifat sintetis.

Respons apa yang seharusnya dikembalikan untuk dokumen yang tidak ditemukan?

Pertama, tentukan apa yang seharusnya terjadi di alamat dokumen tersebut. Halaman yang telah dipindahkan memerlukan penanganan berbeda dari halaman yang sudah tidak ada. Gunakan tabel keputusan ini sebelum mengubah desain halaman tidak ditemukan.

Status dokumen Respons yang diinginkan Tampilan bagi pembaca
Dokumen tersedia di alamat yang diminta 200 OK Dokumen lengkap
Dokumen memiliki pengganti permanen yang jelas Pengalihan 301 Dokumen pengganti di alamat barunya
Dokumen tidak dapat ditemukan dan tidak memiliki pengganti yang setara 404 Not Found Penjelasan yang berguna tentang dokumen yang tidak ditemukan
Dokumen sengaja dihapus dan kemungkinan besar tidak akan tersedia lagi 410 Gone sesuai digunakan Penjelasan penghapusan yang jelas dan navigasi yang berguna

HTTP mendefinisikan 404 tanpa menyatakan apakah ketiadaan tersebut bersifat sementara atau permanen. HTTP mendefinisikan 410 untuk sumber daya yang kemungkinan besar tidak tersedia lagi secara permanen; jika kepastiannya belum diketahui, gunakan 404. Arti ini berasal dari RFC 9110, bagian 15.5.5 dan 15.5.11.

Google merekomendasikan pengalihan permanen ketika dokumen dipindahkan atau memiliki pengganti yang jelas. Jika dokumen dihapus tanpa pengganti serupa, Google merekomendasikan 404 atau 410. Lihat panduan Google untuk menangani respons konten yang tidak ditemukan.

Sebagai contoh, anggap /documents/paper-folding-notes telah dipindahkan ke /documents/paper-folding-guide, dengan instruksi yang secara substansial setara. Pengalihan permanen sesuai untuk perubahan itu. Jika catatan tersebut dihapus tanpa pengganti, pertahankan respons dokumen tidak ditemukan di alamat lama. Tautan ke direktori dokumen umum dapat ditampilkan di halaman tersebut.

Mengapa desain halaman tidak ditemukan yang meyakinkan saja belum cukup

Sebuah halaman dapat secara jelas bertuliskan Dokumen tidak ditemukan, tetapi servernya mengembalikan 200. Google menyebut ketidakcocokan semacam ini sebagai soft 404; halaman kosong atau halaman tanpa konten utama juga dapat diklasifikasikan demikian. Baca penjelasan Google tentang error soft 404.

Status merupakan bagian dari respons HTTP yang terpisah dari konten penjelasan. Karena itu, mengubah judul atau menambahkan label 404 berukuran besar tidak dapat menetapkan kode respons. Periksa permintaan dokumen yang sebenarnya sebelum memutuskan bahwa masalahnya sudah diperbaiki. RFC 9110 menjelaskan fungsi kode status respons.

Bagaimana cara memeriksa respons dokumen di Mac?

Gunakan alat bawaan Chrome untuk pemeriksaan ini. Siapkan satu alamat dokumen yang diketahui berfungsi dan satu jalur yang sengaja dibuat tidak ada di situs publik yang sama. Misalnya, jalur yang tidak ditemukan bisa berupa /documents/missing-paper-example-731. Pilih alamat yang Anda ketahui tidak memiliki dokumen terbitan.

  1. Buka halaman publik di Chrome.
  2. Tekan Command + Option + I untuk membuka DevTools.
  3. Pilih panel Network.
  4. Saat DevTools terbuka, masukkan alamat pengujian di bilah alamat lalu muat halaman tersebut.

Chrome mendokumentasikan pintasan Mac di Membuka Chrome DevTools. Aktivitas jaringan direkam saat DevTools terbuka, sebagaimana dijelaskan dalam ikhtisar panel Network.

  1. Pilih Disable cache agar pemeriksaan ini tidak mengandalkan respons yang tersimpan di cache browser.
  2. Aktifkan Preserve log jika Anda perlu mengikuti navigasi melalui pengalihan.
  3. Muat ulang alamat pengujian.
  4. Pilih permintaan dokumen utamanya, lalu buka Headers. Di bagian General, baca alamat permintaan dan kode statusnya.

Kontrol ini dan lokasi informasi status didokumentasikan dalam referensi fitur Network Chrome.

Periksa permintaan dokumennya dengan saksama. Log tersebut juga memuat permintaan untuk skrip, gaya, dan sumber daya lainnya. Hilangnya berkas pendukung tidak membuktikan bahwa dokumennya sendiri mengembalikan 404. Tabel permintaan Chrome membedakan kode HTTP di Status dan kategori sumber daya di Type; lihat Memeriksa aktivitas jaringan.

Sekarang bandingkan tiga hal: alamat yang awalnya diminta, kode respons untuk dokumen tersebut, dan halaman yang terlihat setelah dimuat. Catat semuanya secara bersamaan. Jika navigasi mengubah alamat, periksa permintaan awal dan alamat tujuannya, bukan hanya halaman akhir.

Bagaimana cara mengubah hasil pengamatan menjadi koreksi?

Tabel diagnostik berikut merupakan sintesis praktis dari arti HTTP dan panduan pemecahan masalah Google. Tabel ini adalah alat bantu pengambilan keputusan, bukan kumpulan hasil pengukuran.

Hasil pengamatan Hal yang perlu diperiksa Koreksi yang diinginkan
200 dengan pesan dokumen tidak ditemukan Penangan rute dokumen tidak ditemukan atau fallback Kembalikan 404 beserta penjelasannya
404 dengan dokumen yang diharapkan terlihat Respons yang ditetapkan untuk rute yang tersedia Sajikan dokumen tersebut dengan sukses menggunakan 200
Pengalihan ke direktori umum Apakah ada pengganti yang setara Alihkan ke dokumen yang setara, atau tampilkan halaman tidak ditemukan
200 dengan dokumen kosong atau tidak lengkap Pemuatan dan perenderan konten Pulihkan konten yang diharapkan jika dokumen masih tersedia
404 dengan pesan halaman tidak ditemukan yang berguna Apakah alamat tersebut benar-benar tidak tersedia Pertahankan perilaku itu jika memang alamatnya tidak tersedia

Dokumentasi pemecahan masalah Google secara jelas membedakan dokumen yang tidak tersedia, dokumen yang dipindahkan, dan dokumen yang masih ada tetapi gagal dimuat dengan benar. Pembedaan ini mencegah halaman yang masih berfungsi tetapi tidak lengkap dianggap sengaja dihapus. Lihat Memecahkan masalah error perayapan Google Search.

Untuk serah terima yang konkret, tulis: “Untuk jalur sintetis yang tidak ditemukan /documents/missing-paper-example-731, kembalikan 404 dan tampilkan halaman dokumen tidak ditemukan khusus di alamat tersebut. Pastikan jalur dokumen yang ada tetap berhasil. Terapkan pengalihan permanen hanya jika pengganti yang setara telah diidentifikasi.” Tambahkan status yang teramati dan pesan yang terlihat dari pemeriksaan Anda.

Permintaan itu menjelaskan perilaku yang diperlukan tanpa menebak nama menu di sistem penerbit Anda. Implementasinya berada di konfigurasi hosting, rute aplikasi, atau sistem penerbitan yang menghasilkan respons tersebut. Google menjelaskan bahwa kode status HTTP dihasilkan oleh server hosting dalam dokumentasi kode status HTTP.

Bagaimana jika editor hanya memungkinkan Anda mengubah konten halaman?

Editor yang mengubah teks atau metadata dokumen mungkin tidak mengendalikan respons HTTP. WHATWG HTML Standard mendefinisikan perilaku khusus untuk direktif meta yang menggunakan http-equiv; pengaturan status respons HTTP tidak termasuk di dalamnya. Karena itu, menambahkan http-equiv="status" bukan cara yang didukung untuk membuat 404. Lihat HTML Standard: Direktif Pragma.

Jika kontrol respons tidak tersedia di editor, gunakan mekanisme halaman tidak ditemukan yang didokumentasikan pada lapisan hosting atau aplikasi. Tanyakan apakah mekanisme tersebut menyajikan konten khusus dengan 404 di alamat yang diminta tetapi tidak ditemukan. Pengaturan yang hanya memilih tata letak halaman error tidak menjawab pertanyaan itu; verifikasi hasilnya dengan alur kerja browser.

Contoh terdokumentasi untuk halaman statis di Netlify

Untuk situs statis yang sudah ada di Netlify, mekanisme yang didokumentasikan adalah berkas bernama 404.html. Netlify otomatis menggunakannya untuk jalur gagal yang tidak mengarah ke berkas statis. Ini adalah contoh khusus penyedia dengan prasyarat: akses ke hasil akhir situs dan build halaman statis yang sudah ada. Netlify mendokumentasikan penanganan 404 khusus.

  1. Gunakan templat halaman situs yang sudah ada untuk membuat halaman dokumen tidak ditemukan.
  2. Pastikan hasil akhir mencakup 404.html di akar direktori publikasi.
  3. Pastikan tidak ada aturan perutean sebelumnya yang mengirim alamat tak dikenal ke halaman lain.
  4. Setelah hasil revisi tersedia di alamat publik, periksa jalur yang tidak ditemukan dan dokumen yang berfungsi.

Pemeriksaan perutean penting karena Netlify memproses perutean sebelum mencapai penanganan berkas statis dan halaman tidak ditemukan terakhir. Permintaan yang sudah ditangani sebelumnya tidak akan mencapai penangan terakhir itu. Dokumentasi Request Chain menjelaskan urutannya. Contoh ini menjelaskan jalur koreksi; ini tidak berarti ada situs yang telah diubah.

Batasan untuk aplikasi yang menggunakan perutean di browser

Beberapa aplikasi baru mengetahui bahwa dokumen tidak tersedia setelah JavaScript dijalankan. Google mengakui bahwa kode status yang bermakna mungkin sulit diterapkan dalam perutean sisi klien. Alternatif yang didokumentasikan adalah pengalihan JavaScript ke alamat yang servernya mengembalikan 404, atau menambahkan metadata noindex ke halaman error. Lihat panduan SEO JavaScript Google.

Alternatif tersebut menghasilkan hal yang berbeda. Pengalihan membawa pengguna ke alamat baru dengan respons halaman tidak ditemukan yang sesungguhnya. Pendekatan metadata menangani pengindeksan tanpa mengubah status HTTP asli. Jika persyaratannya adalah mempertahankan alamat dokumen asli dan mengembalikan 404 di sana, respons hosting atau aplikasi harus mendukung perilaku tersebut.

Apa yang sebaiknya tertulis di halaman dokumen tidak ditemukan?

Gunakan pesan yang singkat dan spesifik, seperti Dokumen ini tidak dapat ditemukan. Lanjutkan dengan satu tindakan berikutnya yang berguna: tautan ke direktori dokumen atau tujuan navigasi lain yang sudah diverifikasi. Pertahankan navigasi dan tampilan situs yang sudah dikenal. Google merekomendasikan bahasa yang jelas, desain yang konsisten, dan tautan yang berguna untuk halaman tidak ditemukan khusus.

Untuk contoh sintetis dokumen lipat kertas, teks yang sesuai adalah: Kami tidak dapat menemukan dokumen tentang melipat kertas ini. Telusuri direktori dokumen untuk memilih panduan lain. Nyatakan bahwa dokumen dihapus secara permanen hanya jika hal itu diketahui. Pastikan penjelasannya terlihat, alih-alih langsung mengirim semua alamat yang tidak ditemukan ke tempat lain.

Bagaimana cara memastikan respons dan halaman sudah sesuai?

Ulangi pemeriksaan dengan beberapa kasus pembanding. Hasil yang diharapkan di bawah ini merupakan kriteria penerimaan ilustratif, bukan hasil pengujian yang dilaporkan.

Kasus pengujian Respons dan halaman yang diharapkan
Dokumen yang diketahui berfungsi 200, dengan dokumen lengkap
Jalur yang sengaja dibuat tidak ada 404, dengan penjelasan dokumen tidak ditemukan
Dokumen yang dihapus tanpa pengganti 404, atau 410 jika sesuai, dengan penjelasan yang akurat
Dokumen yang dipindahkan dengan pengganti setara Pengalihan permanen, diikuti respons sukses dari dokumen pengganti

Uji ulang dengan memasukkan setiap alamat secara langsung dan memuatnya kembali, termasuk dokumen yang biasanya dibuka melalui navigasi di halaman. Langkah ini memeriksa respons yang diterima oleh permintaan dokumen baru. Catat alamat, kode, dan hasil yang terlihat secara bersamaan agar tujuan yang berhasil tidak menyamarkan respons yang keliru sebelumnya dalam navigasi.

Jika hasil lama masih muncul, bedakan cache browser dari cache lainnya. Menonaktifkan cache Chrome menangani cache browser. Cache HTTP juga dapat menyimpan respons negatif seperti 404, jadi respons dokumen tidak ditemukan yang sudah kedaluwarsa mungkin perlu diperiksa melalui perilaku cache yang didokumentasikan oleh sistem penerbitan. RFC 9111 menjelaskan hasil negatif yang dapat disimpan dalam cache.

Untuk Google Search, respons dokumen tidak ditemukan yang sesungguhnya memiliki konsekuensi tertentu: Google tidak mengindeks URL yang mengembalikan 404 atau 410, dan URL yang sebelumnya sudah diindeks akan dihapus saat respons tersebut diproses. Respons 200 yang berhasil juga tidak menjamin pengindeksan. Lihat Pengaruh kode status HTTP terhadap perayap Google.

Selesaikan pemeriksaan saat setiap alamat yang diuji memberikan keterangan yang konsisten: dokumen yang tersedia dimuat dengan sukses, dokumen yang dipindahkan mengarah ke penggantinya, dan dokumen yang tidak tersedia mengembalikan respons yang sesuai disertai navigasi yang berguna. Dengan begitu, Anda memiliki pemeriksaan penerbitan yang konkret dan dapat diulang di Mac.

Sumber