Unduhan Anda berupa HTML, bukan berkas yang diharapkan
Anda mengunduh PDF, tetapi pembacanya tidak dapat membukanya. Atau berkas bernama photos.zip ternyata bukan arsip sama sekali. Sebelum mencoba alat perbaikan, periksa apa yang sebenarnya tersimpan. Anda mungkin mengunduh halaman web yang menjelaskan, melindungi, atau menggantikan berkas tersebut, bukan berkasnya sendiri.
Perbedaan paling penting adalah antara dokumen rusak dan respons yang salah. Kerusakan memengaruhi data dokumen; halaman masuk HTML adalah respons yang sama sekali berbeda. Mengganti nama halaman itu, mengubah ekstensinya, atau mengonversinya tidak dapat memulihkan byte dokumen yang tidak pernah diterima.
1. Kenali respons yang sebenarnya diterima
Jalur salah: HTTP 200 · 149 byte · text/html; charset=utf-8
Jalur benar: HTTP 200 · 2.336 byte · application/pdf
Ini pengukuran pengujian lokal sintetis yang dipertahankan, bukan layanan pihak ketiga langsung.
Pertama, kembali ke halaman berbagi yang tepercaya
Jika hanya membutuhkan satu berkas, mulailah dari situs biasa, bukan pengunduh baris perintah atau ekstensi peramban. Buka tautan asli dari pengirim. Periksa alamat situs yang sebenarnya sebelum memasukkan kata sandi. Jangan mengikuti formulir masuk dalam berkas HTML unduhan yang tidak diharapkan.
- Pastikan item yang dimaksud tersedia. Cari nama berkas, pratinjau, dan pesan akses. Pemberitahuan berkas hilang atau tautan kedaluwarsa bukan unduhan rusak. Mintalah tautan yang berfungsi kepada pengirim.
- Gunakan kontrol Download milik situs. Perintah Simpan halaman pada peramban menyimpan halaman yang sedang dilihat; bukan pengganti mengunduh lampirannya. Begitu pula, menyimpan thumbnail belum tentu mengunduh gambar asli.
- Tunggu sampai unduhan selesai. Buka item yang selesai dari daftar unduhan peramban. Jika ada beberapa salinan bernama mirip, gunakan salinan selesai terbaru, bukan kegagalan lama.
- Periksa dengan aplikasi yang sesuai. Untuk PDF, pastikan halaman yang diharapkan tampil. Untuk arsip, periksa bahwa isinya dapat didaftar serta dokumen yang diharapkan dapat diekstrak dan dibuka.
Dropbox membedakan tautan berbagi dengan keanggotaan folder bersama. Halaman bantuan tautan berbaginya menjelaskan bahwa penerima dapat mengunduh melalui tautan berbagi tanpa bergabung ke folder atau selalu harus membuat akun. Halaman itu menjelaskan ikon unduh berada di kanan atas. Tautan tertentu tetap mungkin memiliki pembatasan. Jika pengunduhan dinonaktifkan, mintalah salinan yang diizinkan kepada pemilik; jangan menganggap URL berbeda sebagai izin untuk melewatinya. Dropbox mendokumentasikan kontrol ini dalam izin tautan berbagi.
Apa yang dapat diberitahukan unduhan HTML
Berkas yang luar biasa kecil adalah petunjuk, bukan diagnosis. Dokumen teks sah bisa sangat kecil, dan halaman kesalahan besar bisa cukup panjang. Nama berkas juga tidak menentukan: pengunduh dapat menyimpan HTML dengan nama berakhiran .pdf, .zip, atau .jpg.
Untuk berkas kecil yang mencurigakan, buat salinan dan gunakan perintah Buka pada editor teks biasa untuk memeriksanya tanpa menyimpan perubahan. Jangan menjalankannya atau mengikuti arahan ke halaman masuk lain. Jika terlihat <!doctype html>, <html>, dan teks halaman seperti “Sign in” atau “File not found”, Anda memiliki bukti bahwa konten tersimpan adalah halaman web. Teksnya mungkin mengisyaratkan apa yang terjadi, tetapi tidak memastikan alasan layanan mengembalikannya.
Karakter yang tidak terbaca di editor teks tidak membuktikan kerusakan. Sebagian besar data PDF dan arsip bukan untuk dibaca sebagai teks biasa. Awalan yang dikenali juga tidak memvalidasi dokumen lengkap atau membuktikan keamanannya. Gunakan pembaca yang tepat untuk format yang diharapkan, dan tetap jalankan pemeriksaan keamanan biasa.
2. Baca byte pertama, bukan ekstensi
Salah: <!doctype html> dan Sign-in required
Contoh yang diharapkan: %PDF-1.4
Tangkapan tampilan sumber asli di bawah dapat digulir mendatar di ponsel tanpa memperkecil hurufnya.
Baca petunjuk yang sama tanpa memperbesar
Teks ini menyalin bukti pengujian lokal yang dipertahankan; bukan tangkapan layar kedua atau respons layanan langsung.
- Kenali respons yang salah. Permintaan lokal mengembalikan HTTP 200,
text/html; charset=utf-8, dan 149 byte. Isi tersimpan diawali<!doctype html>dan memuat<title>Sign-in required</title>. - Bandingkan jalur yang benar. Jalur berkas lokal terpisah mengembalikan HTTP 200,
application/pdf, dan 2.336 byte. Byte pertamanya adalah%PDF-1.4. - Verifikasi apa yang terbuka. Tangkapan pembaca PDF terpisah di bawah menunjukkan contoh yang benar dirender. Awalan PDF maupun HTTP 200 saja tidak membuktikan dokumen unduhan sembarang lengkap atau aman.
Buka tangkapan layar ukuran penuh untuk memeriksa piksel aslinya. Transkrip terbaca di atas membuat pembaca ponsel tidak perlu menguraikan teks tampilan sumber yang kecil.
Ada beberapa penjelasan yang mungkin, dan masing-masing memerlukan langkah berikutnya yang berbeda:
- Anda menyimpan halaman pratinjau. Kembali ke halaman berbagi dan gunakan perintah unduhnya sendiri.
- Permintaan mencapai halaman masuk atau akses. Selesaikan proses masuk sah hanya di layanan terverifikasi, jika Anda berwenang, lalu coba jalur unduh normalnya. Tautan yang bekerja pada peramban dengan akun masuk belum tentu bekerja pada pengunduh lain.
- Tautan tidak lagi berlaku. Minta pengirim memeriksa apakah item masih ada dan apakah tautannya memang ditujukan untuk Anda.
- Alat otomatis menangani respons secara keliru. Alat mungkin berhenti pada pengalihan atau menyimpan halaman tanpa memeriksa konten. Pastikan terlebih dahulu apakah satu unduhan peramban biasa berfungsi.
- Layanan mengalami masalah. Jangan menganggap setiap kegagalan adalah kesalahan lokal. Catat waktu dan kesalahan yang terlihat, lalu periksa informasi dukungan penyedia sendiri.
Contoh terkontrol: nama berkas bukan dokumennya
Tangkapan layar memakai contoh lokal terkontrol: satu jalur mengembalikan halaman akses HTML, dan jalur terpisah menyajikan PDF contoh. Bukan tangkapan Dropbox atau akun pelanggan. Perbandingannya menunjukkan mengapa konten tersimpan lebih penting daripada nama berkas.
Bandingkan tiga hal dalam tangkapan layar: nama berkas tersimpan, isi respons, dan apa yang dapat ditampilkan pembaca dokumen. Nama yang tampak benar belum menjawab persoalannya. Hasil akhir yang berguna adalah dokumen contoh terbaca yang diperoleh melalui jalur benar, bukan sekadar pesan peramban bahwa sesuatu telah diunduh.
Coba penalaran yang sama pada berkas Anda tanpa membagikannya ke mana pun. Pisahkan salinan gagal dari yang berhasil. Buka kembali berkas persis yang baru selesai diunduh. Jika pengirim dapat memberikan jumlah halaman, nama berkas, atau ukuran yang diharapkan, gunakan sebagai pemeriksaan tambahan. Ukuran sama saja bukan bukti isinya identik.
Untuk arsip, ekstraksi berhasil lebih berguna daripada ikonnya. Untuk PDF, periksa lebih dari thumbnail halaman pertama: buka halaman terakhir yang diharapkan dan pastikan materi penting ada. Jika berkas terbuka dengan benar tetapi fitur lain gagal, jangan terus memperlakukannya sebagai masalah unduhan HTML. Gejala baru itu memerlukan diagnosis sendiri.
3. Buka kembali dan periksa berkas sebenarnya
Tangkapan pembaca yang dipertahankan menunjukkan PDF contoh yang benar dirender. Untuk dokumen Anda, periksa juga halaman terakhir yang diharapkan dan isi pentingnya. HTTP 200 dan awalan PDF saja tidak cukup.
Ketika pengunduh menyatakan berhasil tetapi menyimpan halaman
Jika Anda memelihara skrip atau membantu orang memecahkan masalahnya, periksa respons akhir, bukan hanya status permintaan berhasil. Respons HTTP berhasil dapat berupa halaman HTML yang sepenuhnya valid, tetapi bukan berkas yang diinginkan. Catat operasi yang diminta, status akhir, jenis media yang dikembalikan, dan hasil validasi tanpa menyimpan token tautan privat atau isi respons.
Header respons Content-Type menjelaskan jenis media yang dikembalikan. Melihat text/html ketika mengharapkan PDF adalah alasan untuk berhenti dan memeriksa jalur permintaan. Header bukan validator berkas lengkap: server dapat salah melabeli konten. Gabungkan dengan validasi berkas tersimpan yang memahami format.
Jangan mencetak header autentikasi, cookie, tautan berbagi privat, atau isi dokumen pribadi ke tiket pemecahan masalah. Diagnostik yang berguna dapat menyatakan “mengharapkan PDF, menerima HTML, unduhan peramban normal berhasil” tanpa mengekspos berkas dasarnya. Jika peramban normal juga gagal, sertakan bunyi kesalahan yang terlihat dan waktunya, lalu minta pengirim atau pemilik layanan menyelidiki.
Untuk pekerjaan batch, validasi satu unduhan yang diizinkan sebelum menjalankan seluruh daftar. Hentikan saat ada ketidaksesuaian, bukan menyimpan ratusan halaman kesalahan identik. Pisahkan keluaran gagal dari berkas yang disetujui agar proses selanjutnya tidak mengimpornya hanya karena ekstensi terlihat benar. Hindari permintaan otomatis berulang ke endpoint yang gagal; percobaan ulang tidak menyelesaikan akses yang tidak tersedia atau tautan yang dicabut.
Jika Anda memelihara tautan berbagi Dropbox
Dokumentasi tautan unduh Dropbox mendukung dl=1 untuk meminta unduhan alih-alih pratinjau. Dokumentasi itu juga mengingatkan bahwa parameter kueri yang ada perlu ditangani dengan benar dan pengalihan mungkin terjadi. Pertahankan tautan asli yang diizinkan, bukan menyusunnya ulang dari nama berkas.
Kode ilustratif ini mengubah parameter unduh sambil mempertahankan parameter kueri lainnya. Token adalah placeholder; contoh ini mengedit URL tanpa mengunduh apa pun:
const link = new URL(
"https://www.dropbox.com/scl/fi/EXAMPLE/example.zip" +
"?rlkey=EXAMPLEKEY&dl=0"
);
link.searchParams.set("dl", "1");
console.log(link.searchParams.get("rlkey")); // EXAMPLEKEY
console.log(link.searchParams.get("dl")); // 1
Jangan menambahkan tanda tanya kedua atau menghapus parameter akses saat merapikan alamat. Jangan pula menganggap perubahan parameter memberi akses. Tautan kedaluwarsa, terhapus, atau dibatasi tetap memerlukan penyelesaian oleh pemilik. Hindari konverter “direct link” pihak ketiga untuk URL privat.
Diskusi historis komunitas Dropbox mencatat unduhan otomatis yang mengembalikan HTML. Balasan staf melaporkan perbaikan di sisi layanan, dan seorang peserta mengonfirmasi unduhan kembali berfungsi; balasan berikutnya menggambarkan masalah yang lebih sempit. Ini bukti bahwa gejala tersebut bisa memiliki lebih dari satu penyebab, bukan bukti gangguan saat ini atau perbaikan universal. Artikel sebelumnya juga menautkan laporan pengguna publik; anggap laporan perorangan sebagai catatan gejala, bukan diagnosis otoritatif.
Ketahui kapan harus berhenti memperbaiki berkas yang salah
Jika kontrol Download normal situs tepercaya masih menyimpan HTML, kirim nama berkas yang diharapkan dan pesan yang terlihat kepada pemilik. Minta mereka memverifikasi akses dan berkas aslinya. Jangan unggah dokumen privat atau halaman akses ke layanan perbaikan yang tidak dikenal. Dokumen yang hilang masih berada di sumber; perangkat lunak perbaikan tidak dapat membangunnya kembali dari halaman masuk.
Jika sudah memperoleh arsip valid tetapi Windows tidak dapat mengekstrak jalur bertingkat yang panjang, lihat panduan panjang jalur ZIP. Jika berkas baik tetapi namanya ditolak saat sinkronisasi, lihat panduan nama berkas OneDrive. Itu tahap berikutnya dalam alur kerja, bukan alasan terus mengubah berkas HTML unduhan.
Garis akhir praktisnya sederhana: berkas yang dimaksud tersimpan, aplikasi yang benar dapat membacanya, dan isi yang diharapkan tersedia. Pertahankan berkas asli sampai titik itu tercapai. Ekstensi baru, bilah kemajuan selesai, atau status HTTP berhasil hanyalah bagian kecil pemeriksaan tersebut.


