Tüm Ürünler
Search
Belge Merkezi

CDN:Purge and prefetch troubleshooting guide

Son Güncelleme:Oct 21, 2026

Bu konuda, gönderilemeyen temizleme veya ön yükleme görevleri, temizleme sonrası anormal kalan içerik, tamamlanmayan görevler veya beklentileri karşılamayan ön yükleme sonuçları ile ilgili sorunların nasıl giderileceği açıklanmaktadır.

Temizleme veya ön yükleme görevinin başarılı olup olmadığını belirleme

Görevin başarıyla gönderilmesi, görevin tamamlanması ve geçerli isteğin önbelleğe isabet etmesi ayrı ayrı doğrulamanız gereken üç farklı durumdur. Sorun gidermeye başlamadan önce görev türünü, gönderim zamanını, tam URL'yi, görev kimliğini ve konsol hata mesajını kaydedin.

Önemli: Bir temizleme veya ön yükleme görevi başarıyla gönderildikten sonra iptal edilemez. Bir görevi göndermeden veya yeniden göndermeden önce URL listesini, görev türünü ve kapsamını doğrulayın. Ön yükleme görevleri için kaynak sunucunun kapasitesini de değerlendirin. İstemci betiğini durdurmak veya konsol sayfasını kapatmak gönderilmiş bir görevi iptal etmez.

  1. Görev durumunu kontrol edin: CDN konsolundaki işlem kayıtlarında görevin var olduğunu, durumunun Tamamlandı ve ilerlemenin %100 olduğunu doğrulayın. Görev görünmüyorsa başarıyla gönderilmemiş olabilir. Bir görev uzun süre tamamlanmamış olarak kalıyorsa veya başarısız durumu gösteriyorsa görev yürütme durumunu kontrol etmeye devam edin.

  2. Kaynak durumunu kontrol edin: CDN'i atlayarak ilgili kaynak kaynağına erişin. Kaynağın beklenen içeriği ve yanıt üstbilgilerini döndürdüğünü doğrulayın; durum kodunu, yanıt içeriğini, Last-Modified, ETag ve Cache-Control değerlerini kaydedin. Bir kaynak Host, protokol, bağlantı noktası veya URL yeniden yazma yapılandırılmışsa kaynağı gerçek kaynak getirme yapılandırmasına göre ilgili yol ve sorgu parametreleri dahil olmak üzere doğrulayın. Kaynak hala eski içeriği veya anormal bir yanıt döndürüyorsa önce kaynağı düzeltin.

  3. CDN yanıtını kontrol edin: Hızlandırılmış URL'ye gerçek hizmet istek yöntemiyle erişin. Durum kodunu, yanıt içeriğini ve Age, Via ve X-Cache gibi yanıt üstbilgilerini kaydedin ve bunları kaynak sonuçlarıyla karşılaştırın. HIT veya MISS yalnızca geçerli isteği yansıtır ve belirli bir görevin başarılı veya başarısız olduğunu bağımsız olarak kanıtlayamaz.

  4. İstemci önbelleğini etkisiz hale getirin: URL'ye özel tarama modunda veya tarayıcı önbelleğini temizledikten sonra tekrar erişin. CDN önbelleğini temizlemek tarayıcı, proxy veya diğer istemci önbelleklerini temizlemez.

Bir görev gönderilemiyor

Konsol veya API tarafından döndürülen hata mesajına dayanarak sırasıyla giriş formatını, izinleri ve kotaları kontrol edin.

Bir temizleme veya ön yükleme görevi gönderirken URL format hatası veya desteklenmeyen görev türü sorununu nasıl çözerim?

  1. Hızlandırılmış bir alan adı altında eksiksiz bir HTTP veya HTTPS URL'si girdiğinizden emin olun, kaynak URL'si değil. Her satıra bir URL girin. Birden çok URL'yi virgülle birleştirmeyin.

  2. Bir URL Çince karakterler, boşluklar veya diğer ASCII olmayan karakterler içeriyorsa önce UTF-8 kullanarak yüzde kodlaması yapın. Zaten kodlanmış bir yüzde dizisini tekrar kodlamayın.

  3. Ön yükleme yalnızca belirli dosya URL'lerini destekler, dizinleri değil. Dizin URL'si / ile bitmelidir ancak bunu yalnızca dizin temizlemeleri için kullanabilirsiniz.

  4. URL imzalama, parametre yok sayma, özel önbellek anahtarı veya URL yeniden yazma kullanıyorsanız gönderilen URL'nin gerçek önbellek anahtarı kurallarıyla eşleştiğinden emin olun.

Her görev türünün giriş gereksinimleri için bkz. Yordam.

Bir temizleme veya ön yükleme görevi gönderirken aşılmış kota, hız sınırı veya dolu kuyruk sorununu nasıl çözerim?

  1. Kota sınırlarını kontrol edin: Gönderim başına sınır her partide gönderebileceğiniz URL sayısını kontrol eder. Günlük kota bir günde gönderebileceğiniz toplam sayıyı kontrol eder. Dakika başına hız sınırı gönderim oranını kontrol eder. Ön yükleme kuyruğu kapasitesi kuyruğun tutabileceği URL sayısını kontrol eder. Gönderim başına sınırı aşarsanız URL'leri partilere bölün. Hız sınırını aşarsanız gönderim sıklığını azaltın. Günlük kotayı tüketirseniz sıfırlanmasını bekleyin veya kota artışı talep edin. Geçerli partideki URL sayısını azaltmak tükenmiş günlük kotayı çözmez.

  2. Ön yükleme kuyruğu dolu: Yeniden göndermeden önce mevcut görevlerin çalışıp kuyruk kapasitesini serbest bırakmasını bekleyin. Aynı URL partisinden sürekli yeniden deneme yapmayın. Kuyruk kapasitesi günlük ön yükleme kotası değildir ve kuyruğu boşaltmak zaten tüketilmiş günlük kotayı geri yüklemez. Toplu iş betiği yalnızca önceki partinin tamamlandığını veya açıkça başarısız olduğunu onayladıktan sonra devam etmelidir.

  3. URL listesinde yinelemeleri kontrol edin ve URL'leri sıcak içerik önceliğine göre partilere bölün. Genellikle sıcak olmayan dosyaların ön yüklenmesine gerek yoktur.

  4. İşletmeniz daha yüksek bir kota gerektiriyorsa konsolda belirtildiği şekilde kota artırma talebi gönderin. Aşağıdaki tabloda kotalar açıklanmaktadır:


    Yöntem


    Kota limiti


    URL temizleme


    Hesap başına günde en fazla 10.000 URL


    Dizin temizleme


    Gönderim başına en fazla 100 dizin; alan adı başına dakikada en fazla 100 dizin


    Düzenli ifade temizleme


    Hesap başına günde en fazla 20 kural


    URL ön yükleme


    Gönderim başına en fazla 100 URL; hesap başına günde en fazla 1.000 URL

Temizleme veya ön yükleme API'sini çağırırken izin reddedildi veya AccessDenied hatasını nasıl çözerim?

  1. Geçerli kimlik bilgilerinin ait olduğu hesabın hedef hızlandırılmış alan adını yönetebileceğinden emin olun. Yetkilendirme ilkesindeki kaynak kapsamının alan adını içerip içermediğini kontrol edin.

  2. Temizleme API'sini çağırmak için cdn:RefreshObjectCaches izni gerekir. Ön yükleme API'sini çağırmak için cdn:PushObjectCache izni gerekir. Bu API'lerden yalnızca birini çağırırsanız bu işlem için izin verin. Diğer görev türünü göndermek için izin vermenize gerek yoktur. Konsolu kullanıyorsanız veya görevleri ya da kotaları sorguluyorsanız ayrıca gerçek işlemlerin gerektirdiği cdn:DescribeRefreshTasks ve cdn:DescribeRefreshQuota gibi sorgu izinlerini de verin.

  3. Geçici kimlik bilgileri kullanıyorsanız kimlik bilgilerinin süresinin dolmadığından ve oturum ilkesinin bu işlemleri veya hedef kaynakları daha fazla kısıtlamadığından emin olun.

RAM yetkilendirme izinlerine sahip bir yönetici en az ayrıcalık ilkesine dayalı olarak eksik izinleri vermelidir. Talimatlar ve temizleme ile ön yükleme ilke örnekleri için bkz. Alibaba Cloud CDN özel ilkeleri.

Temizleme sonrası içerik güncellenmiyor

Bir görev tamamlandıktan sonra hala eski içeriği, yanıt üstbilgilerini veya hata yanıtlarını görüyorsanız kaynak durumunu, CDN'de önbelleğe alınan nesneleri ve istemci önbelleklerini ayırt edin.

İstekler hala eski içeriği veya yanıt üstbilgilerini döndürdüğünde tamamlanmış bir temizleme görevini nasıl gideririm?

  1. Kaynağı kontrol edin: CDN'i atlayarak gerçek kaynak getirme Host, protokol, bağlantı noktası, yol ve sorgu parametrelerini kullanarak ilgili kaynak kaynağına erişin. Kaynağın yeni içeriği ve yanıt üstbilgilerini döndürdüğünü doğrulayın. Kaynak hala eski sürümü sunuyorsa önce kaynağı düzeltin.

  2. Görev URL'sini kontrol edin: Protokol, ana bilgisayar adı, yol, sorgu parametreleri, URL yeniden yazma ve imzalama parametrelerini kontrol ederek görevin gerçek önbellek anahtarını hedeflediğinden emin olun. İş sorgu parametreleri / içeriyorsa gönderimden önce %2F olarak kodlayın. Yol ayırıcılarını değiştirmeden bırakın ve zaten kodlanmış bir yüzde dizisini tekrar kodlamayın.

  3. Sayfanın başvurduğu alt kaynakları kontrol edin: HTML ve başvurduğu JS ve CSS dosyaları ayrı önbelleğe alınmış nesnelerdir. Önce kaynak HTML'nin yeni dosyalara başvurduğunu doğrulayın ardından içeriği güncellenen ancak dosya adları değişmeyen alt kaynakların URL'lerini temizleyin. Uzun vadeli bir çözüm için aynı adla değiştirmeye güvenmek yerine içerik hash'i içeren dosya adları kullanın.

  4. Temizleme türünü kontrol edin: Tek bir dosya için önbelleği doğrudan silmek amacıyla URL temizleme kullanın. Dizin, düzenli ifade ve parametre yok sayma temizlemeleri varsayılan olarak koşullu kaynak getirmeleri yapabilir. Kaynak 304 döndürür ancak içerik aslında değiştiyse RefreshObjectCaches kullanarak Force=true ayarlayın.

  5. İstemci önbelleğini etkisiz hale getirin: URL'ye özel tarama modunda veya tarayıcı önbelleğini temizledikten sonra tekrar erişin. CDN önbelleğini temizlemek tarayıcı önbelleğini temizlemez.

Kaynak dosyası geri yüklendikten sonra CDN'in hala döndürdüğü geçmiş 404 veya diğer hata yanıtlarını nasıl çözerim?

  1. CDN'i atlayarak gerçek kaynak getirme Host, protokol, bağlantı noktası, yol ve sorgu parametrelerini kullanarak ilgili kaynak kaynağına erişin. Kaynağın artık normal bir yanıt döndürdüğünü doğrulayın.

  2. Önbelleğe alınmış hata yanıtını silmek için belirli dosya URL'sini temizleyin.

  3. Durum kodu önbelleğe alma kurallarını kontrol ederek 404 gibi hata yanıtları için önbellek süresinin beklendiği gibi olduğundan emin olun. Genel önbellek kuralı tanılama için bkz. Önbellek sorun giderme.

Yalnızca bazı bölgeler veya CDN düğümleri hala eski içeriği döndürdüğünde bir temizlemeyi nasıl gideririm?

  1. Temizleme görevinin tamamlandığından emin olun ve normal ile anormal isteklerin tam URL'lerini, DNS çözümleme sonuçlarını, Via, Age, X-Cache ve yanıt içeriğini karşılaştırın.

  2. Sırasıyla normal ve anormal istekler için gerçek kaynak getirme Host, protokol, bağlantı noktası, yol ve sorgu parametrelerini kullanarak CDN'i atlayarak ilgili kaynak kaynaklarına erişin. Farklı kaynakların veya protokollerin farklı sürümler döndürmesini ortadan kaldırın.

  3. Farklı isteklerin sorgu parametreleri, çerezler, istek üstbilgileri veya özel önbellek anahtarı nedeniyle farklı önbelleğe alınmış kopyalara düşmediğinden emin olun. Sorunu hala lokalize edemiyorsanız daha fazla sorun giderme için görev kimliğini, sorunun oluştuğu zamanı, istemci IP adresini ve tam yanıt üstbilgilerini sağlayın.

Bir görev tamamlanmıyor veya ön yükleme sonuçları beklentileri karşılamıyor

Tamamlanmış bir ön yükleme görevi yalnızca hedef kaynağın görev kurallarına göre kaynak getirme katmanı önbelleğine yazıldığı anlamına gelir. Her L1 düğümünde anında önbelleğe isabet garantisi vermez ve tüm kullanıcılar için indirme hızlarının iyileştiği anlamına gelmez.

Uzun süre tamamlanmamış olarak kalan veya başarısız durumu gösteren bir temizleme veya ön yükleme görevini nasıl gideririm?

  • Görev durumunu görev kimliğine göre sorgulayın. Gönderim API'sinden gelen başarılı yanıtı görevin tamamlandığının kanıtı olarak kabul etmeyin.

  • Kuyruk kapasitesini, URL sayısını, kaynak yanıt süresini ve başarısız URL'leri kontrol edin. Büyük dosyalar veya çok sayıda URL içeren görevleri partilere bölün.

  • Görevleri toplu iş betiği kullanarak gönderiyorsanız her partinin yürütme sonucunu görev kimliğine göre doğrulayın. Betiğin kullanımıyla ilgili talimatlar için bkz. İçeriği temizlemek ve ön yüklemek için betik kullanma.

İlk istek hala MISS gösterdiğinde veya yavaş yanıt verdiğinde tamamlanmış bir ön yükleme görevini nasıl gideririm?

  • Varsayılan olarak ön yükleme kaynakları CDN kaynak getirme katmanı düğümlerine yazar ve tüm L1 uç düğümlerini anında kapsamaz. Belirli bir L1 düğümüne yapılan ilk istek hala MISS gösterebilir.

  • Aynı önbellek anahtarına eşlendiklerinden emin olmak için istek URL'sinin ve ön yükleme URL'sinin protokolünü, ana bilgisayar adını, yolunu ve sorgu parametrelerini karşılaştırın.

  • HIT yalnızca geçerli isteğin önbelleğe isabet ettiğini kanıtlar ve MISS tek başına ön yüklemenin başarısız olduğunu kanıtlamaz. Görev durumunu, düğüm katmanını, Age, Via'yı ve ardışık GET isteklerinin sonuçlarını birlikte değerlendirin.

Kaynak 30X döndürdüğünde başarısız bir ön yükleme görevini nasıl gideririm?

Bu bölüm, bir ön yükleme görevi başarısız olduğunda ve gerçek kaynak getirme yapılandırması kullanılarak erişildiğinde kaynağın 30X yönlendirmesi döndürdüğü durumlar için geçerlidir. Hizmet URL'sinden gelen 30X yanıtı tek başına ön yükleme görevinin başarısız olduğunu kanıtlamaz.

Sorun giderme adımları:

  1. Kaynak yönlendirmesini doğrulayın: CDN'i atlayarak gerçek kaynak getirme Host, protokol, bağlantı noktası, yol ve sorgu parametrelerini kullanarak bir GET isteği gönderin. Durum kodunu ve Konumu kaydedin. Yönlendirmeleri başlangıçta otomatik olarak takip etmeyin çünkü bu yalnızca son yanıtı gösterebilir ve ara yönlendirmeleri gizleyebilir.

    Konumun erişilebilir belirli bir dosya URL'si olup olmadığını kontrol edin ve son yanıtın bir oturum açma sayfası, hata sayfası veya dizin adresi olmadığından emin olun.

  2. Yönlendirme takibini kontrol edin: Kaynak 301 veya 302 döndürdüğünde CDN yalnızca alan adı için kaynak getirme 301/302 yönlendirme takibi etkinleştirilmişse Konum adresine erişmeye devam eder. Bu özellik 307 ve 308 gibi yönlendirmeler için geçerli değildir. Bu yanıtlar için önce kaynak yönlendirme kurallarını ayarlayın veya hedef dosyayı doğrudan sunan hızlandırılmış alan adı altında bir URL'yi yeniden gönderin. Yönlendirme takibini etkinleştirmek başarılı bir ön yüklemeyi garanti etmez. Ayrıca yönlendirme sayısı limitini, hedef ulaşılabilirliğini ve son yanıtı kontrol edin. Yapılandırma talimatları için bkz. 301/302 yönlendirmesini yapılandırma.

  3. Ön yükleme nesnesini kontrol edin: Belirli bir dosya URL'si gönderdiğinizden emin olun. Ön yükleme dizin URL'lerini desteklemez.

  4. URL formatını kontrol edin: URL tam protokol önekini içermeli ve tam genişlikli karakterler veya ekstra boşluklar içermemelidir. Her satıra bir URL girin. URL'leri virgülle ayırmayın. ASCII olmayan karakterleri UTF-8 kullanarak yüzde kodlaması yapın ve zaten kodlanmış bir yüzde dizisini tekrar kodlamayın.

  5. URL yeniden yazmayı kontrol edin: Düğümler önbellek anahtarını oluşturmak için yeniden yazılan URL'yi kullanır. Konsolda bir görev gönderirken yeniden yazılan URL'yi kullanın. API aracılığıyla bir görev gönderirken ayrıca QueryHashkey parametresini kontrol edin. true olarak ayarlandığında API alan adı yapılandırmasına göre ön yükleme URL'sinin gerçek önbellek anahtarını sorgular. Parametre ayrıntıları için bkz. PushObjectCache.

  6. CDN URL imzalama parametrelerini kontrol edin: Ön yükleme görevi gönderirken CDN URL imzalama parametrelerini kaldırın ancak iş sorgu parametrelerini saklayın. Sorgu dizesinin tamamını silmeyin. Sorgu parametrelerindeki / karakterini %2F olarak kodlayın ve yol ayırıcılarını değiştirmeden bırakın. Görevin başarıyla gönderilmesi URL'nin hedef önbellek anahtarıyla eşleştiği anlamına gelmez. Kaynağın ayrı kimlik doğrulama gereksinimleri varsa ayrıca 403 döndüren veya kimlik doğrulaması başarısız olan ön yükleme URL'sini nasıl gideririm? bölümünde açıklandığı gibi kaynak erişim izinlerini de kontrol edin.

403 döndüren veya kimlik doğrulaması başarısız olan ön yükleme URL'sini nasıl gideririm?

Sorun giderme adımları:

  1. Kaynağın CDN kaynak getirmelerine izin verdiğinden emin olmak için hedef URL'ye doğrudan erişin. Kaynak hotlink koruması, IP kısıtlamaları, URL imzalama veya diğer erişim kontrol kurallarının ön yükleme isteğini reddedip reddetmediğini kontrol edin.

  2. Kaynak belirli istek üstbilgileri veya kimlik doğrulama bilgileri gerektiriyorsa WithHeader parametresini kullanarak PushObjectCache aracılığıyla ön yükleme görevini gönderin.

Ön yükleme sırasında hızlı başlayıp yavaşlayan indirme hızlarını veya artan kaynak yükünü nasıl ele alırım?

Birden çok kaynak getirme katmanı düğümü kaynakları eşzamanlı olarak aldığında kaynak bant genişliği, bağlantı sayısı veya disk kapasitesi darboğaz haline gelebilir. Ön yükleme kapsamını azaltın, görevleri partiler halinde gönderin ve sıcak büyük dosyalara öncelik verin.

Video gibi büyük dosyalar için kaynak Range isteklerini destekliyorsa ve 206 kısmi yanıtları doğru döndürüyorsa yalnızca segmentleri almak için aralık kaynak getirme kullanmayı düşünün. Aralık kaynak getirme kaynak getirme QPS'yi artırır ve kaynak hız sınırlamasını tetikleyebilir. Tam bir dosyanın ön yüklenmesi kısa bir süre içinde kaynak getirme trafiğini veya kaynak yükünü artırabilir.