
Ini salah satu momen paling memeningkan kepala selepas menerbitkan kemas kini laman web: di komputer riba anda, susun atur baharu dan warna butang terkini sudah muncul dengan cantik. Tetapi apabila anda hantar pautan ke klien melalui WhatsApp dan mereka membukanya di telefon, mereka masih nampak susun atur semalam. Anda pun tekan refresh di telefon sendiri berkali-kali—sama juga, masih versi lama.
Naluri pertama kita selalunya menyalahkan proses deploy, padahal dalam kebanyakan kes, fail baharu sudah lama berada di pelayan. Yang berlaku ialah pelayar telefon (atau rangkaian CDN) masih memegang salinan lama kerana arahan cache memberitahunya bahawa salinan itu masih sah.
Kenal pasti bahagian mana yang “tertinggal”
Sebelum menekan butang Purge Everything di Cloudflare secara membuta tuli, periksa apa sebenarnya yang kelihatan lama di telefon itu:
- Teks artikel sudah baharu, tetapi susun atur CSS atau interaksi JS masih lama. Ini hampir pasti berpunca daripada URL aset yang tidak berubah (contohnya
/assets/styles.css). Jika pelayan menghantar headerCache-Control: public, max-age=86400untuk fail CSS tersebut, pelayar telefon berhak sepenuhnya untuk tidak bertanya kepada pelayan lagi selama 24 jam berikutnya. - Seluruh teks halaman dan tarikh masih versi semalam. Di sini, masalahnya berada pada dokumen HTML itu sendiri—sama ada peraturan cache CDN sedang menyimpan HTML terlalu lama,
Service Worker(jika ada PWA) sedang menyaji versi lama, atau anda sebenarnya melihat cabang/persekitaran preview yang berbeza daripada domain produksi.
Cara paling cepat mengasingkan masalah ialah membuka URL yang sama dalam tetingkap Incognito / Private di telefon. Jika Incognito menunjukkan versi baharu tetapi tab biasa menunjukkan versi lama, puncanya 100% cache di dalam pelayar telefon anda. Jika Incognito pun masih menunjukkan versi lama, semak header HTTP respons di pelayan atau CDN.
Penyelesaian kekal: tukar nama fail aset (cache busting), bukan purge setiap kali
Anda tidak boleh menyuruh ribuan pelawat menekan Ctrl+Shift+R atau memadam sejarah pelayar di telefon mereka. Satu-satunya cara yang boleh diharap untuk CSS, JavaScript, dan gambar yang boleh berubah ialah mengubah URL fail setiap kali kandungannya berubah—sama ada menggunakan hash kandungan (styles.a8f3c2.css) atau rentetan versi semasa proses build (styles.css?v=33b491).
Apabila HTML baharu merujuk kepada styles.css?v=33b491 dan bukan lagi ?v=10a220, pelayar telefon tidak perlu membuang cache lama pun—ia terus mengenali URL itu sebagai fail baharu dan memuat turunnya serta-merta.
Untuk dokumen HTML pula, gunakan polisi cache yang membenarkan pengesahan semula (revalidation) dengan cepat—contohnya Cache-Control: public, max-age=0, must-revalidate bersama ETag. Menurut dokumentasi aset statik Cloudflare Workers, pelayan pinggir secara lalai menyokong pengesahan ETag supaya pelayar boleh menyemak dengan pantas sama ada HTML telah berubah tanpa memuat turun semula keseluruhan fail jika tiada perubahan.
Tabiat ringkas selepas setiap pelancaran
Selepas selesai deploy kemas kini visual yang besar, ambil telefon sendiri (pada data mudah alih, bukan Wi-Fi pejabat), buka halaman utama dan satu halaman artikel dalam mod biasa, kemudian semak tiga benda: teks terkini, gaya CSS terkini, dan gambar yang baru ditambah. Apabila strategi versi URL dan header HTML disusun betul sejak awal, anda jarang sekali perlu risau tentang pengguna yang terperangkap melihat laman web minggu lepas.