本頁說明如何在執行本機執行作業時調查快取失敗情形。
本頁假設您已具備可在本機成功建構的建構作業和/或測試，並且設定為利用遠端快取功能，而且您想確保遠端快取的用法能發揮效果。
如要瞭解如何檢查快取命中率，以及如何比較兩次 Bazel 叫用作業之間的執行記錄，請參閱「偵錯遠端執行作業的遠端快取命中」。該指南中所述的所有內容也適用於搭配本機執行作業的遠端快取。不過，本機執行作業會帶來一些額外的挑戰。
檢查快取命中率
成功的遠端快取命中會顯示在狀態行中，類似於搭配遠端執行作業的快取命中率。
在 Bazel 執行作業的標準輸出內容中，您會看到類似以下的內容：
INFO: 7 processes: 3 remote cache hit, 4 linux-sandbox.
也就是說，在 7 個嘗試動作中，有 3 個獲得遠端快取命中，而 4 個動作沒有快取命中，並使用 linux-sandbox 策略在本機執行。這份摘要中不包含本機快取命中次數。如果取得 0 個程序 (或數字低於預期)，請執行 bazel clean，後面接著建構/測試指令。
快取命中問題
如果快取未達到預期的快取命中率，請按照下列指示操作：
確保與遠端端點的通訊成功
如要確保您的版本可順利與遠端快取服務通訊，請按照本節中的步驟操作。
檢查輸出內容是否出現警告
在遠端執行作業中，如果無法與遠端端點通訊，建構作業就會失敗。另一方面，如果快取可快取的本機建構作業無法快取，也不會失敗。檢查 Bazel 叫用作業的輸出內容，看看是否有警告訊息，例如：
WARNING: Error reading from the remote cache:或
WARNING: Error writing to the remote cache:這類警告後面會出現錯誤訊息，詳細說明連線問題，有助您進行偵錯，例如輸入錯誤的端點名稱或憑證設定有誤。找出並解決這類錯誤。如果您看到的錯誤訊息沒有提供足夠的資訊，請嘗試新增
--verbose_failures。按照排解遠端執行作業的快取命中問題一文中的步驟操作，確保能夠透過快取寫入 Bazel 叫用，確保能在同一部機器上和多個機器中取得快取命中資料。
確保快取讀取的 Bazel 叫用作業可取得快取命中。
a. 由於快取讀取 Bazel 叫用的設定不同，因此請謹慎確保這些指令列的設定正確，可與遠端快取進行通訊。確認已設定
--remote_cache標記，且輸出內容中沒有警告。b. 確保快取讀取 Bazel 叫用的目標，與快取寫入 Bazel 叫用的目標相同。
c. 按照與確保跨機器快取一節的步驟進行，確保從快取寫入 Bazel 叫用的內容快取到快取讀取 Bazel 叫用。