Setelah mengaktifkan akselerasi Alibaba Cloud CDN, beberapa elemen halaman gagal dimuat karena penyaringan parameter menghapus string kueri sebelum meneruskan permintaan ke origin. Nonaktifkan penyaringan parameter untuk memulihkan akses.
Gejala
Setelah akselerasi CDN diaktifkan untuk domain Anda, pengunjung melaporkan bahwa elemen tertentu—seperti gambar, skrip, atau resource lainnya—gagal dimuat. Domain tersebut berfungsi dengan baik sebelum akselerasi CDN diterapkan.
Penyebab
Penyaringan parameter diaktifkan pada domain CDN Anda. Saat aktif, CDN menghapus semua parameter string kueri dari URL sebelum meneruskan permintaan ke server origin. Contohnya:
Pengunjung meminta:
https://example.com/image.jpg?version=2&size=largeCDN meneruskan ke origin:
https://example.com/image.jpg
Hal ini memengaruhi perilaku cache dalam dua cara:
Semua permintaan untuk resource yang sama—terlepas dari parameter string kueri—dianggap identik dan dilayani dari salinan cache tunggal.
Resource yang bergantung pada parameter kueri untuk mengembalikan konten berbeda (seperti gambar yang dihasilkan secara dinamis atau aset berbasis API) menerima respons yang salah atau tidak lengkap.
Jika website Anda menggunakan URL dengan parameter setelah tanda tanya (?), penyaringan parameter menyebabkan permintaan tersebut gagal atau mengembalikan hasil yang tidak sesuai.
Solusi
Nonaktifkan penyaringan parameter untuk domain yang terdampak.
Masuk ke Konsol Alibaba Cloud CDN dan klik Domain Names di panel navigasi sebelah kiri.
Temukan nama domain yang ingin Anda kelola dan klik Manage di kolom Actions. Pada halaman pengelolaan, nonaktifkan penyaringan parameter.
Verifikasi perbaikan
Setelah menonaktifkan penyaringan parameter, pastikan pemuaian elemen telah dipulihkan:
Bersihkan cache browser dan cache CDN untuk domain yang terdampak.
Minta resource menggunakan URL yang menyertakan parameter kueri.
Verifikasi bahwa konten yang benar dimuat. Jika origin Anda mengembalikan respons berbeda berdasarkan parameter kueri, pastikan setiap varian dilayani dengan benar.
Praktik terbaik
Perhatikan hal-hal berikut untuk menghindari masalah serupa:
Gunakan urutan parameter yang konsisten. CDN memperlakukan URL dengan parameter yang sama namun dalam urutan berbeda sebagai kunci cache terpisah. Misalnya,
image.jpg?color=red&size=largedanimage.jpg?size=large&color=reddi-cache sebagai dua objek berbeda. Selalu cantumkan parameter dalam urutan yang sama—urutan alfabet merupakan konvensi yang andal.Gunakan penulisan huruf parameter yang konsisten. Nama dan nilai parameter bersifat case-sensitive dalam pencocokan kunci cache. Gunakan huruf kecil secara konsisten di seluruh URL Anda.
Tinjau penyaringan parameter sebelum mengaktifkannya. Penyaringan parameter hanya sesuai untuk resource yang parameter kuerinya tidak memengaruhi respons—misalnya, parameter pelacakan yang ditambahkan ke URL aset statis. Mengaktifkannya untuk resource dinamis atau yang bergantung pada parameter akan menyebabkan masalah ini.