查詢快取政策部署錯誤

您正在查看 Apigee 和 Apigee Hybrid 說明文件。
查看 Apigee Edge 說明文件。

InvalidTimeout

錯誤訊息

透過 Apigee UI 或 API 部署 API Proxy 時失敗，並顯示以下錯誤訊息：

Error Saving Revision revision_number
CacheLookupTimeoutInSeconds value value should be greater than zero.

錯誤訊息範例

Error Saving Revision 2
CacheLookupTimeoutInSeconds -1 value should be greater than zero.

錯誤螢幕截圖範例

儲存修訂版本 2 時發生錯誤。

原因

如果 LookupCache 政策的 <CacheLookupTimeoutInSeconds> 元素設為負數，API Proxy 的部署作業就會失敗。

舉例來說，如果 <CacheLookupTimeoutInSeconds> 元素為 -1，則 API Proxy 的部署作業會失敗。

診斷

  1. 找出 LookupCache 政策中 <CacheLookupTimeoutInSeconds> 元素指定的無效值。您可以在錯誤訊息中找到這項資訊。舉例來說，在以下錯誤中，<CacheLookupTimeoutInSeconds> 元素使用的無效值為 -1：

    CacheLookupTimeoutInSeconds -1 value should be greater than zero.

  2. 請檢查發生失敗的特定 API Proxy 中，所有 LookupCache 政策。LookupCache 政策中可能會有一或多個 <CacheLookupTimeoutInSeconds> 元素。找出 LookUpCache 政策，其中 <CacheLookupTimeoutInSeconds> 元素指定了無效的值 (請參閱上方步驟 1)。

    舉例來說，下列政策設定會指定 -1 的 <CacheLookupTimeoutInSeconds> 值，與錯誤訊息相符：

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<LookupCache async="false" continueOnError="false" enabled="true" name="LookupCache-Token">
    <DisplayName>LookupCache-Token</DisplayName>
    <Properties/>
    <CacheKey>
        <Prefix/>
        <KeyFragment ref="request.queryparam.client_id"/>
    </CacheKey>
    <CacheLookupTimeoutInSeconds>-1</CacheLookupTimeoutInSeconds>
    <Scope>Exclusive</Scope>
    <ExpirySettings>
        <TimeoutInSec>3600</TimeoutInSec>
    </ExpirySettings>
    <AssignTo>usertoken</AssignTo>
</LookupCache>

  3. 如果 <CacheLookupTimeoutInSeconds> 指定為負整數，則該為錯誤原因。

解決方法

請務必將 LookupCache 政策的 <CacheLookupTimeoutInSeconds> 元素值一律設為非負整數。

如要修正上述 LookupCache 政策範例，您可以將 <CacheLookupTimeoutInSeconds> 元素修改為 30。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<LookupCache async="false" continueOnError="false" enabled="true" name="LookupCache-Token">
    <DisplayName>LookupCache-Token</DisplayName>
    <Properties/>
    <CacheKey>
        <Prefix/>
        <KeyFragment ref="request.queryparam.client_id"/>
    </CacheKey>
    <CacheResource>tokencache</CacheResource>
    <CacheLookupTimeoutInSeconds>30</CacheLookupTimeoutInSeconds>
    <Scope>Exclusive</Scope>
    <ExpirySettings>
        <TimeoutInSec>3600</TimeoutInSec>
    </ExpirySettings>
    <AssignTo>usertoken</AssignTo>
</LookupCache>

InvalidCacheResourceReference

錯誤訊息

透過 Apigee UI 或 API 部署 API Proxy 時失敗，並顯示以下錯誤訊息：

Error Deploying Revision revision_number to environment
Invalid cache resource reference [cache_resource] in Step definition [populate_cache_policy_name]. Context Revision:[revision_number];APIProxy:ResponseCache;Organization:[organization];Environment:[environment]

錯誤訊息範例

Error Deploying Revision 2 to test
Invalid cache resource reference tokencache in Step definition LookupCache-Token. Context Revision:2;APIProxy:TestCache;Organization:kkalckstein-eval;Environment:test

錯誤螢幕截圖範例

部署修訂版本 2 至測試時發生錯誤。

原因

如果 <CacheResource> 元素的名稱在部署 API Proxy 的環境中不存在，就會發生這個錯誤。

診斷

  1. 找出 LookupCache 政策的 <CacheResource> 元素中使用的無效快取，以及發生錯誤的環境。您可以在錯誤訊息中找到這兩項項目。舉例來說，在以下錯誤中，無效快取的名稱為 tokencache，環境名稱為 test。

    Invalid cache resource reference tokencache in Step definition LookupCache-Token. Context Revision:2;APIProxy:TestCache;Organization:kkalckstein-eval;Environment:test

  2. 請檢查發生失敗的特定 API Proxy 中，所有 LookupCache 政策。找出特定的 LookupCache 政策，其中在 <CacheResource> 元素中指定了無效快取 (在步驟 1 中指出)。

    舉例來說，下列政策將 <CacheResource> 的值指定為 tokencache，與錯誤訊息相符：

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<LookupCache async="false" continueOnError="false" enabled="true" name="LookupCache-Token">
    <DisplayName>LookupCache-Token</DisplayName>
    <Properties/>
    <CacheKey>
        <Prefix/>
        <KeyFragment ref="request.queryparam.client_id"/>
    </CacheKey>
    <CacheResource>tokencache</CacheResource>
    <CacheLookupTimeoutInSeconds/>
    <Scope>Exclusive</Scope>
    <ExpirySettings>
        <TimeoutInSec>3600</TimeoutInSec>
    </ExpirySettings>
    <AssignTo>usertoken</AssignTo>
</LookupCache>

  3. 確認是否已在特定環境 (在步驟 1 中指出) 定義快取 (在步驟 1 中判斷)。

    在 Apigee UI 中，依序前往「ADMIN」>「Environment」>「test」，然後檢查「Caches」分頁中的「Caches」分頁中是否有快取。如果快取不存在，則是錯誤的原因。

    例如，請注意下方螢幕截圖中，名為 tokencache 的快取不存在。

    「Environment Configuration」(環境設定) 分頁中的「Caches」(快取) 分頁。

    由於 test 環境中未定義名為 tokencache 的快取，因此您會收到以下錯誤訊息：

    Invalid cache resource reference tokencache in Step definition LookupCache-Token. Context Revision:2;APIProxy:TestCache;Organization:kkalckstein-eval;Environment:test

解決方法

請確認您已在要部署 API Proxy 的環境中，建立 <CacheResource> 元素中指定的快取名稱。

CacheNotFound

錯誤訊息

透過 Apigee UI 或 API 部署 API Proxy 會產生類似以下的錯誤訊息，且 API Proxy 的部署狀態會標示為已部分部署：

Error: Cache : cache_resource, not found in organization : organization__environment.

錯誤訊息範例

Error Cache : configCache, not found in organization : kkalckstein-eval__test

原因

如果未在特定的 Message Processor 元件上建立錯誤訊息中提及的特定快取，就會發生這個錯誤。

解決方法

如需協助，請與 Apigee 支援團隊聯絡。