排解 Cloud CDN 問題

瞭解實用的疑難排解步驟，解決您在使用 Cloud CDN 時遇到的問題。

如果您遇到的問題與外部後端有關，請參閱排解外部後端和網際網路 NEG 問題。

常見問題和解決方案

本節將說明一些常見問題及其解決方法。

系統沒有快取回應

如果回應未快取，請先確認後端服務或後端值區是否已啟用 Cloud CDN。啟用 Cloud CDN 後，系統可能需要幾分鐘的時間才會開始快取回應。

Cloud CDN 只會快取含有可快取內容的回應。這項資訊會透過 HTTP 回應標頭傳送，並與後端設定搭配使用。使用 cdn_cache_status 設定自訂回應標頭時，您可以在 Cloud CDN 記錄檔中觀察快取狀態，並判斷是否因快取失敗而提供回應。

如果系統未快取網址的回應，請檢查該網址傳回的標頭，以及後端的快取功能設定方式。

您可以透過以下幾種方式檢查回應標頭：

• 在 Google Chrome 中，請使用 DevTools 網路面板
• 在 Mozilla Firefox 中，請使用開發人員工具網路監視器
• 使用 curl 或 GNU Wget 等指令列工具

以下範例示範如何使用 curl 檢查 http://example.com/style.css 的 HTTP 回應標頭：

curl -s -D - -o /dev/null http://example.com/style.css

輸出：

HTTP/1.1 200 OK
Date: Tue, 16 Feb 2016 12:00:00 GMT
Content-Type: text/css
Content-Length: 1977
Via: 1.1 google

將這些標頭與可快取內容需求條件進行比較，就會發現回應缺少必要的 Cache-Control 標頭 (假設快取模式設為 USE_ORIGIN_HEADERS)。

標頭的設定方法需視原始伺服器的類型而定。如果您在 Compute Engine 上執行網路伺服器，請參閱網路伺服器軟體的說明文件，進一步瞭解如何設定回應標頭。在 Cloud Storage 中，將物件標示為公開共用會導致系統傳送適當的標頭。

重新設定原始伺服器以新增必要標頭後，您可以再次使用 curl 檢查結果：

curl -s -D - -o /dev/null http://example.com/style.css

輸出：

HTTP/1.1 200 OK
Date: Tue, 16 Feb 2016 12:00:30 GMT
Content-Type: text/css
Content-Length: 1977
Cache-Control: max-age=86400,public
Via: 1.1 google

curl -s -D - -o /dev/null http://example.com/style.css

輸出：

HTTP/1.1 200 OK
Date: Tue, 16 Feb 2016 12:00:31 GMT
Content-Type: text/css
Content-Length: 1977
Cache-Control: max-age=86400,public
Via: 1.1 google

curl -s -D - -o /dev/null http://example.com/style.css

輸出：

HTTP/1.1 200 OK
Date: Tue, 16 Feb 2016 12:00:30 GMT
Content-Type: text/css
Content-Length: 1977
Cache-Control: max-age=86400,public
Via: 1.1 google
Age: 2

本例中的最後一個回應包含 Age 標頭。Cloud CDN 會在快取中提供的回應中加入 Age 標頭。這裡的標頭表示已利用 2 秒前建立的快取項目，成功從快取提供回應。

此外，如果在後端執行個體中啟用 ETags，Cloud CDN 會依據 ETag 確認物件的新鮮度。如果後端執行個體在同一個物件上提供不同的 ETag，Cloud CDN 會將不相符的內容視為快取失敗，並重新整理物件。為避免這種情況發生，後端執行個體必須提供相同的 ETag，或必須停用 ETag。

如要確認這一點，請重複執行 curl，並觀察 ETag 值是否有變化：

curl -s -D - -o /dev/null http://example.com/image.png

輸出：

HTTP/2 200
date: Fri, 20 Mar 2020 15:02:30 GMT
server: Apache
strict-transport-security: max-age=31536000; includeSubDomains
last-modified: Mon, 16 Mar 2020 04:20:59 GMT
etag: "10f-5a0f1256f1402"
accept-ranges: bytes
content-length: 271
cache-control: public, max-age=864000
expires: Mon, 30 Mar 2020 15:02:30 GMT
vary: Accept-Encoding
x-xss-protection: 1; mode=block
x-content-type-options: nosniff
content-type: image/png
via: 1.1 google
alt-svc: clear

curl -s -D - -o /dev/null http://example.com/image.png

輸出：

HTTP/2 200
date: Fri, 20 Mar 2020 15:03:11 GMT
server: Apache
strict-transport-security: max-age=31536000; includeSubDomains
last-modified: Mon, 16 Mar 2020 04:18:31 GMT
etag: "10f-5a0f11ca09b7a"
accept-ranges: bytes
content-length: 271
cache-control: public, max-age=864000
expires: Mon, 30 Mar 2020 15:03:11 GMT
vary: Accept-Encoding
x-xss-protection: 1; mode=block
x-content-type-options: nosniff
content-type: image/png
via: 1.1 google
alt-svc: clear

無法存取 Cloud Storage 物件

如要提供 Cloud Storage 中的物件存取權，您必須設定已簽署的網址，或是為 allUsers 授予該值區及其所有物件的公開存取權。

如果您決定要提供 allUsers 存取權，可以按照以下步驟驗證物件層級存取權：

如要進一步瞭解 Cloud Storage 的存取權控管，請參閱 Cloud Storage 的身分與存取權管理 (IAM) 說明文件。

如要進一步瞭解已簽署的網址，請參閱「使用已簽署的網址」。

如果您可以存取物件，但系統未予以快取，請參閱「系統沒有快取回應」。

快取的內容為私人內容，或快取的內容不正確

如果您知道原始伺服器提供私人或不正確內容的原因並能夠修正問題，則可以使用下列程序撤銷 Cloud CDN 快取：

1. 確保原始伺服器不再傳回私人或不正確的內容。
2. 要求撤銷快取，指示 Cloud CDN 停止提供快取內容。

詳情請參閱快取撤銷總覽。

Cloud CDN 只會快取含有可快取內容的回應，並在回應中指定的到期時間前，從快取中提供回應。如果您不知道系統為何快取這項內容，或是無法適當修正問題，可以先停用 Cloud CDN，等到您瞭解並修正問題後，再重新啟用。如要進一步瞭解快取的內容及時間長度，請參閱快取總覽。

快取命中率偏低

為了提升效能和擴充性，請務必改善快取命中率。如果快取命中率低於預期，請務必遵循最佳做法，改善快取命中率。

請參閱下表，瞭解快取命中率偏低的可能原因和可能的修正方式。

相同內容有多個快取填補作業

一般來說，透過增加可快取回應的到期時間，就能降低快取填補數。在其他條件相同的情況下，您會發現使用 Cache-Control: public, max-age=86400 的回應，比使用 Cache-Control: public, max-age=1 的回應，快取填入的次數較少。

如要進一步瞭解到期時間，請參閱「到期時間和驗證要求」。如要瞭解如何設定適當的回應標頭，請參閱網路伺服器軟體的說明文件。

Cloud CDN 在全球各地運作許多快取，並定期移除舊的快取項目，以騰出空間存放新內容。因此，每個資源都會在正常運作期間多次填入快取。

壓縮無法作用

Cloud CDN 提供動態壓縮功能，適用於無法壓縮回應的原始來源。建議您盡可能在來源端使用壓縮功能，因為這樣可降低快取填充成本。

如果 Cloud CDN 提供的回應沒有壓縮，但應該要壓縮，請檢查在執行個體上執行的網路伺服器軟體是否設為壓縮回應。根據預設，部分網頁伺服器軟體會自動為包含 Via 標頭的要求停用壓縮功能。Via 標頭的存在表示要求是由 Proxy 轉送。外部應用程式負載平衡器等 HTTP Proxy，會依據 HTTP 規格在每個要求中新增 Via 標頭。如要啟用壓縮功能，您可能需要覆寫網路伺服器的預設設定，讓伺服器在要求含有 Via 標頭時，壓縮回應。

如果您使用的是 nginx 網路伺服器軟體，請修改 nginx.conf 設定檔以啟用壓縮功能。這個檔案的位置取決於 nginx 的安裝位置。在許多 Linux 發行版中，檔案會儲存在 /etc/nginx/nginx.conf。

如要讓 nginx 壓縮功能與外部應用程式負載平衡器搭配運作，請在 nginx.conf 的 http 區段中新增下列兩行：

gzip_proxied any;
gzip_vary on;

• 第一行會啟用壓縮功能，即使是外部應用程式負載平衡器等 Proxy 轉送的要求也是如此。

• 第二行會在回應中新增 Vary: Accept-Encoding 標頭。Vary: Accept-Encoding 會通知 Cloud CDN 等快取代理程式，請為可壓縮資源的壓縮和非壓縮變數分別保留快取項目。

修改 nginx.conf 後，您必須重新啟動 nginx，才能使用新的設定。在許多 Linux 發行版中，您可以執行 sudo service nginx restart 或 /etc/init.d/nginx restart 來重新啟動 nginx。

回應因 byte_range_caching_aborted 錯誤而終止

當 Cloud CDN 從多個位元組範圍要求組合回應時，會比較 ETag 和 Last-Modified 回應標頭，檢查這些範圍是否來自相同版本的資源。如果 Cloud CDN 發現任一標頭的值與已提供給用戶端的範圍不一致，就會中止回應。

如果您發現意外終止的回應、含有 byte_range_caching_aborted statusDetails 的 Cloud Logging 記錄項目，或是執行個體傳回 412 Precondition Failed 回應，請確認在所有虛擬機器 (VM) 執行個體上執行的網路伺服器軟體，針對特定資源傳回相同的 ETag 和 Last-Modified 值。

從磁碟提供檔案時，網路伺服器軟體通常會從檔案的修改時間衍生出 ETag 和 Last-Modified 值。在這種情況下，您可以為所有執行個體使用相同的映像檔，確保 VM 執行個體回報的值一致。如要進一步瞭解網頁伺服器軟體如何判斷 ETag 和 Last-Modified 值，請參閱網頁伺服器軟體的說明文件。

排解已簽署 Cookie 的問題

使用已簽署的 Cookie時，可能會發生下列問題。

編碼

產生簽名時，由於簽名不相符，要求會意外遭到拒絕。

編碼 URL 和 Signature 值時，請務必使用 Base64 的網址安全變體。如果產生的字元不安全，標準 base64 就會失敗。可接受邊框。

簽署

Cloud CDN 已拒絕您的要求。

• 請確認您使用 HMAC-SHA-1 做為簽署演算法，而非 HMAC 的其他變化版本。

• 確認 (區分大小寫) KeyName 參數與 Cloud CDN 使用的後端服務或後端值區的有效鍵名相符。

• 產生及簽署 URLPrefix 時，請勿簽署查詢參數。請確認 URLPrefix 只包含網址的架構、主機和 (部分) 路徑元件。

• 請確認簽章區塊 (URLPrefix、Expires、KeyName 和 Signature 本身) 是 Cookie 中最後一個以 : 分隔的區塊。

• 請確認 URLPrefix、Expires、KeyName 和 Signature 會依序出現。

• 請勿在已簽署的 Cookie 中，在 URLPrefix 的結尾加上星號 (*) 字元。

Cookie

• 瀏覽器通常會將 Cookie 限制為每個網域 4 KB，且每個網域的 Cookie 總數上限為 50 個。請注意您發出的其他 Cookie，並要求您的用戶端傳送這些 Cookie，因為許多網路伺服器也有要求的請求標頭上限。

• 請確認您使用的是冒號字元 (:) 和 Unicode 代碼點 U+003A，做為已簽署 Cookie 中命名參數的分隔符，而非 ampersand (&) 字元。

• 請確認您發出的 Cookie 中 Expires 時間戳記並未過短。如果有效期少於一到兩分鐘，則在發出應用程式和 Cloud CDN 基礎架構之間，可能會發生時鐘偏差問題。

• 請確認您不會為相同的 Domain 和 Path 設定多個 Cookie，且這些 Cookie 的值不同。為每位使用者設定單一 Cookie，並使用網址前置字串值涵蓋使用者需要存取的所有內容。

錯誤訊息

本節提供一些常見錯誤訊息的資訊，以及如何解決這些錯誤。

快取撤銷錯誤

已知問題

• 快取撤銷的頻率限制為每分鐘每個網址對應只能進行一次撤銷。

  解決方法：請至少等候一分鐘，再嘗試讓其他網址對應無效。

  如要進一步瞭解快取撤銷頻率限制，請參閱「限制」一節。