CDN：重新整理和預熱相關常見問題

重新整理和預熱有什麼區別？

重新整理和預熱是兩種不同的操作：

• 重新整理：向 CDN 節點下發緩衝失效指令，標記已緩衝的資源為到期。使用者再次請求時，CDN 節點回源擷取最新資源並返回給使用者，同時重新緩衝。重新整理會降低快取命中率。

• 預熱：CDN 節點主動從來源站點拉取資源並緩衝到節點上。使用者首次請求時可以直接從 CDN 節點擷取資源，無需回源。預熱會提高快取命中率。

重新整理和預熱有先後順序嗎？

重新整理和預熱通常是兩種獨立的操作，沒有嚴格的先後順序。實際應用中，根據情境會有自然的邏輯順序。當來源站點資源更新，需要更新 CDN 節點緩衝時：

• 先重新整理：刪除 CDN 緩衝中的舊檔案，讓後續訪問擷取到來源站點上的最新內容。

• 後預熱：重新整理任務生效後進行預熱操作，將最新內容緩衝到 CDN 節點，保證使用者在最短時間內擷取到最新內容。

• 首次接入 CDN：若節點無緩衝，可直接執行預熱操作，將資源緩衝到 CDN 節點。

重新整理預熱時，輸入來源站點 URL 還是加速網域名稱 URL？

重新整理預熱操作針對加速網域名稱下的 URL，需輸入加速網域名稱下的 URL，而非來源站點原始 URL。CDN 系統通過加速網域名稱識別和管理緩衝資源，對加速網域名稱下指定路徑的重新整理或預熱可以確保 CDN 節點上的緩衝內容得到及時更新或提前載入。

如何重新整理泛網域名稱的緩衝？

阿里雲 CDN 不支援直接重新整理整個泛網域名稱下的所有緩衝內容，需要對具體子網域名稱的目錄或特定 URL 路徑分別提交重新整理請求，不能直接輸入 https://*.example.com/file01.html 或 https://*.example.com/file02/。重新整理多個 URL 時，請按一行一個 URL 輸入。

重新整理和預熱任務需要多久生效？

• 重新整理任務：提交後大約 5～6 分鐘在全網生效。如果資源的緩衝到期時間小於此值，則無需手動重新整理。

• 預熱任務：取決於檔案大小和數量，通常需要 5～30 分鐘。

CDN配置修改後如何快速生效？

修改CDN配置（如回源Host、緩衝規則、回應標頭等）通常對新請求生效。但如果邊緣節點已緩衝了舊回應標頭或內容，新配置不會立即覆蓋已有緩衝。要使配置變更快速生效，需手動重新整理對應的URL或目錄緩衝，強制邊緣節點回源擷取最新配置下的資源。

例如，修改回應標頭或緩衝時間後，可登入CDN控制台的重新整理快取頁面面，輸入需要重新整理的URL或目錄路徑並提交重新整理請求。若涉及配置變更導致的內容類型（Content-Type）不一致，需先在來源站點修正中繼資料後，再對相應URL執行重新整理操作。

預熱請求是否支援攜帶自訂要求標頭？

預熱請求預設攜帶的 Header 是 Accept-Encoding: gzip。如需在預熱請求中攜帶其他 Header 或實現多副本預熱，可使用 OpenAPI 介面查詢重新整理預熱任務-按ID。

配置 CDN 後如何對檔案進行同名更新？

使用 CDN 加速資源時，請參見以下方法進行檔案更新：

• 對於一般檔案更新，推薦在上傳時為資源 URL 添加版本號碼（如 ?v=1.0），避免同名更新帶來的緩衝問題。

• 對於必須進行同名更新的檔案，可從控制台或 OpenAPI 提交重新整理請求。控制台操作請參見重新整理和預熱資源，OpenAPI 操作請參見重新整理預熱。

為什麼JS/CSS檔案名稱更新後，僅重新整理首頁無效？

瀏覽器和CDN都會緩衝具體的JS/CSS檔案URL。若檔案名稱未變但內容更新，或檔案名稱已變但HTML中引用未更新，僅重新整理首頁可能導致子資源仍命中舊緩衝。

建議：

• 直接重新整理具體的JS/CSS檔案URL，而非僅重新整理首頁。

• 為資源URL添加版本號碼參數（如?v=1.0），避免同名更新導致的緩衝問題。

• 若來源站點發生同名更新，請通過CDN控制台手動重新整理對應URL的緩衝，重新整理後稍等幾分鐘再使用無痕模式重新訪問測試。

為什麼使用 CDN 重新整理預熱功能後訪問的資源沒有更新？

問題原因：資源未更新的常見原因有以下幾種：

• 使用 CDN 重新整理預熱雖然清除了 CDN 緩衝，但受到瀏覽器緩衝的影響，導致訪問到舊的資源。

• 來源站點的資源沒有更新，本身就是舊的資源。

• 重新整理預熱任務沒有執行完畢。

• 使用目錄重新整理時，CDN 預設採用標記到期機制（標記重新整理），回源驗證時攜帶 If-Modified-Since 或 If-None-Match 要求標頭。如果來源站點同名檔案的 Last-Modified 或 ETag 未變更，來源站點返回 304 Not Modified，CDN 繼續使用舊緩衝。

解決方案：根據問題原因選擇對應的解決方案：

• 清理瀏覽器緩衝後重新整理頁面，查看資源是否更新，或使用無痕模式/更換瀏覽器訪問測試。

• 將網站網域名稱直接繫結來源站（通過修改本地 host 的方式），直接存取來源站點檢查資源是否更新。如果資源沒有更新，請先更新來源站點資源，再使用 CDN 加速。

• 登入重新整理和預熱資源。

• 改用 URL 精確重新整理（File 類型）直接刪除具體檔案的緩衝，或調用 RefreshObjectCaches API 並將 Force 參數設定為 true，強制移除 CDN 節點緩衝而非標記到期。

在重新整理預熱頁面單擊操作記錄頁簽，查看對應任務的狀態是否為完成、進度是否為100%，以確認重新整理預熱任務已執行完畢。

已經進行了緩衝預熱，為什麼下載速度先快後慢？

CDN 預熱是多個節點同時進行下載，開始某個節點的下載速度較快，隨著更多節點的加入，下載速度受到來源站點伺服器頻寬的影響，呈現先快後慢的情況。對於頻寬較小的來源站點伺服器所需預熱時間會更長。建議評估來源站點頻寬，必要時提升頻寬或分批次預熱。

來源站點返回 30X 重新導向狀態代碼，會對資源預熱有什麼影響？

預熱時，如果來源站點返回 307 等重新導向相關的狀態代碼，預熱任務不會跟隨重新導向地址繼續完成預熱，最終會導致預熱失敗。如果來源站點返回的是 301 或者 302 狀態代碼，並且 CDN 上已經開啟了回源 301/302 跟隨，這種情況下正常預熱不受影響。

來源站點檔案刪除或內容更新後，CDN仍返回舊內容或404如何處理？

CDN節點存在歷史緩衝，即使來源站點檔案已刪除或更新，緩衝仍可能被訪問到。處理方法：

1. 在CDN控制台或通過API對具體URL執行重新整理操作。

2. 若為目錄級緩衝策略影響，建議對整個目錄進行重新整理。如需徹底清除，調用RefreshObjectCaches API並將Force參數設定為true進行強制重新整理。

3. 確認來源站點檔案已確實更新或刪除。

如何排查CDN預熱失敗的原因？

預熱失敗請按以下步驟逐一排查：

1. 檢查URL是否可正常訪問：確認預熱的URL瀏覽器可直接存取並返回200狀態代碼。若返回308等重新導向狀態代碼，請預熱帶有斜杠結尾的正確URL地址。

2. 確認未預熱目錄：預熱僅支援具體檔案URL，不支援以/結尾的目錄路徑。

3. 檢查OSS動態加速影響：若來源站點為OSS且開啟了動態加速，可能導致靜態檔案不走緩衝路徑，建議關閉動態加速或指定靜態檔案類型。

4. 檢查URL格式：URL須包含完整協議頭（http://或https://），無非法字元（全形字元、多餘空格等）。多個URL之間用換行分隔，不能用逗號。

5. 檢查資源可緩衝性：確認預熱資源未被設定Cache-Control: no-cache/no-store/private等不可緩衝頭。

是否需要分別對HTTP和HTTPS重新整理和預熱？

不需要，只需要重新整理或預熱HTTP或HTTPS其中一種即可。例如您需要預熱aaa.mp4檔案，您只需預熱https://example.com/aaa.mp4即可，不必再預熱http://example.com/aaa.mp4。