Lewati ke konten
FrAIFlow

Solusi / Berkas & Berbagi

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.

Respons HTTP lokal nyata membandingkan byte HTML dengan byte PDF valid
Permintaan lokal nyata: keduanya menghasilkan HTTP 200, tetapi jalur salah mengembalikan 149 byte HTML dan jalur berkas mengembalikan 2.336 byte PDF. Endpoint sintetis ini bukan Dropbox atau akun pelanggan. Buka gambar asli.

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.

  1. 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.
  2. 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.
  3. 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.
  4. 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.

Tampilan sumber Chrome nyata menunjukkan respons lokal bernama PDF diawali HTML dan judul masuk
Tampilan sumber Chrome nyata dari respons lokal bernama .pdf. <!doctype html> dan judul HTML yang terlihat menunjukkan isi halaman web, bukan byte PDF. Bilah alamat tidak tertangkap; permintaan lokal tepatnya dan sumber dipertahankan bersama eksperimen. Tidak ada layanan masuk nyata yang diakses. Buka gambar asli.

Baca petunjuk yang sama tanpa memperbesar

Teks ini menyalin bukti pengujian lokal yang dipertahankan; bukan tangkapan layar kedua atau respons layanan langsung.

  1. 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>.
  2. Bandingkan jalur yang benar. Jalur berkas lokal terpisah mengembalikan HTTP 200, application/pdf, dan 2.336 byte. Byte pertamanya adalah %PDF-1.4.
  3. 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:

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.

PDF sintetis yang benar dirender pada pembaca PDF Chrome
Endpoint yang benar terbuka sebagai PDF contoh di pembaca Chrome nyata. Status HTTP berhasil saja tidak dapat memastikan perbedaan ini. Buka gambar asli.

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.

Bukti sebelumnya dan referensi terkait