排解 Java 呼叫政策執行階段錯誤

您目前查看的是 Apigee Edge 說明文件。
前往 Apigee X 說明文件。
info

ResourceDoesNotExist

錯誤訊息

透過 Edge UI 或 Edge 管理 API 部署 API Proxy 時失敗,並顯示這則錯誤訊息:

Error Deploying Revision <var>revision_number</var> to <var>environment</var>
Resource with name <var>ResourceURL</var> and type java does not exist.

錯誤訊息範例

Error Deploying Revision 1 to test
Resource with name myresource.jar and type java does not exist.

錯誤螢幕截圖範例

原因

如果 JavaCallout 政策中 <ResourceURL> 元素指定的資源不存在於 API Proxy、環境或機構層級,API Proxy 的部署作業就會失敗。

診斷

  1. 找出環境和資源名稱。這項資訊會顯示在錯誤訊息中。舉例來說,在下列錯誤中,環境為 test,而 <ResourceURL> 元素中使用的資源名稱為 myresource.jar。

    Error Deploying Revision 1 to test
    Resource with name myresource.jar and type java does not exist.
    
  2. 找出使用上述步驟 1 中所識別資源的 JavaCallout 政策。

    舉例來說,下列政策將 <ResourceURL> 指定為 myresource.jar,與錯誤訊息中的值相符:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <JavaCallout name="hello-java">
        <ClassName>com.apigeesample.HelloJava</ClassName>
        <ResourceURL>java://myresource.jar</ResourceURL>
    </JavaCallout>
    
  3. 判斷資源是屬於失敗的 API Proxy,還是上傳至環境或組織層級。如果不是,這就是錯誤原因。

    • 前往 API Proxy 編輯器的「Navigator」窗格,然後點選「Resources」分頁,即可查看在 API Proxy 層級上傳的所有資源。在本例中,API Proxy 沒有上傳任何資源。

    • 資源可在環境或機構層級提供。詳情請參閱「資源檔案」。

      • 如要判斷資源是否存在於環境層級,請使用 curl 發出下列 API 呼叫: curl -v -u <strong>email </strong>"https://api.enterprise.apigee.com/v1/organizations/myorg/environments/myenv/resourcefiles/java/myresource.jar"

      • 如要判斷資源是否存在於機構層級,請使用 curl 發出下列 API 呼叫,並省略環境詳細資料: curl -v -u email "https://api.enterprise.apigee.com/v1/organizations/myorg/resourcefiles/java/myresource.jar"

      如果這些 API 的回應是 404 狀態碼,表示機構和環境層級都缺少資源。

    如果 API Proxy、機構和環境層級沒有資源,系統會傳回部署錯誤:

    Resource with name myresource.jar and type java does not exist.
     ```
    

解析度

請確認 <ResourceURL> 元素中指定的資源確實存在於 API Proxy、環境或組織層級。詳情請參閱「資源檔案」。

如要更正上述 JavaCallout 政策範例,請在適當層級 (API Proxy、機構或環境層級) 上傳 JAR 檔案。

NoResourceForURL

錯誤訊息

透過 Edge UI 或 Edge 管理 API 部署 API Proxy 時失敗,並顯示這則錯誤訊息:

Error in deployment for environment <var>environment</var>
The revision is deployed, but traffic cannot flow. Could not locate a resource with URL <var>ResourceURL</var>

錯誤訊息範例

Error in deployment for environment test
The revision is deployed, but traffic cannot flow. Could not locate a resource with URL java://myresource.jar

錯誤螢幕截圖範例

原因

即使資源檔案顯示存在於 API Proxy、環境或組織層級,如果檔案損毀或部分上傳,仍可能發生這項錯誤。

診斷

  1. 找出環境和資源名稱。這項資訊會顯示在錯誤訊息中。舉例來說,在下列錯誤中,環境名稱為 test,<ResourceURL> 元素中使用的資源名稱為 myresource.jar。

    Error in deployment for environment test
    The revision is deployed, but traffic cannot flow. Could not locate a resource with URL java://myresource.jar
    
  2. 請確認資源是在 API Proxy、環境或機構層級上傳。在下方範例中,您可以看到資源 myresource.jar 是在 API Proxy 層級上傳。

    資源可在環境或機構層級提供。詳情請參閱「資源檔案」。

    如要判斷資源是否存在於環境層級,請使用 curl 發出下列 API 呼叫: curl -v -u <strong>email </strong>"https://api.enterprise.apigee.com/v1/organizations/myorg/environments/myenv/resourcefiles/java/myresource.jar"

    如要判斷資源是否存在於機構層級,請使用 curl 發出下列 API 呼叫,並省略環境詳細資料: curl -v -u email "https://api.enterprise.apigee.com/v1/organizations/myorg/resourcefiles/java/myresource.jar"

    如果這些 API 的回應是 404 狀態碼,表示機構和環境層級都缺少資源。

解析度

  1. 如果判斷資源存在於 API Proxy、機構或環境層級,請刪除資源並重新上傳,如步驟 2 所述。否則,請跳到步驟 3。
  2. 如要在 API Proxy 層級刪除資源,請前往 API Proxy 編輯器的「Navigator」窗格,然後點按資源旁的「X」按鈕,如下所示。

    如要在環境或機構層級刪除資源,請在先前診斷步驟中使用的 API 呼叫上使用 DELETE 動詞。舉例來說,如要刪除環境層級的資源,請輸入下列指令: curl -X DELETE -v -u <strong>email </strong>"https://api.enterprise.apigee.com/v1/organizations/myorg/environments/myenv/resourcefiles/java/myresource.jar"

  3. 在適當層級 (API Proxy、機構或環境層級) 上傳 JAR 檔案。

  4. 如果重新上傳資源無法解決問題,請重新啟動受影響的 Message Processor。如果您在 Cloud 中使用 Apigee Edge,請與 Apigee 支援團隊聯絡。 如果是私有雲使用者,請參閱「啟動、停止、重新啟動及檢查 Apigee Edge 的狀態」。

JavaCalloutInstantiationFailed

錯誤訊息

透過 Edge UI 或 Edge 管理 API 部署 API Proxy 時失敗,並顯示這則錯誤訊息:

Error in deployment for environment <var>environment</var>
The revision is deployed, but traffic cannot flow. Failed to instantiate the JavaCallout Class <var>class_name</var>

或

Error in deployment for environment <var>environment</var>.
The revision is deployed and traffic can flow, but flow may be impaired. Failed to instantiate the JavaCallout Class <var>class_name</var>

錯誤訊息範例

Error in deployment for environment test
The revision is deployed, but traffic cannot flow. Failed to instantiate the JavaCallout Class my.class

錯誤螢幕截圖範例

原因

以下是導致這項錯誤的常見原因

原因 說明
缺少 JAR 檔案 您未上傳含有錯誤中識別的 Java 類別的 JAR 檔案。
JAR 檔案已毀損 含有錯誤中識別的 Java 類別的 JAR 檔案已損毀/部分上傳。
缺少 Class 檔案 錯誤中識別的 Java 類別檔案,不屬於 >ResourceURL< 中指定的 JAR 檔案或依附元件 JAR 檔案。
Java 程式碼問題 程式碼有錯誤,例如缺少建構函式、程式碼依附元件問題或其他問題。

常見診斷步驟

  1. 找出環境名稱和匯入失敗的類別。舉例來說,在下列錯誤訊息中,環境名稱為 test,類別名稱為 my.class:

    Error in deployment for environment test
    The revision is deployed, but traffic cannot flow. Failed to instantiate the JavaCallout Class my.class
    
    

    原因:缺少 JAR 檔案

診斷

  1. 找出應包含類別 (如上述步驟 1 所述) 但無法例項化的 JAR 檔案。
  2. 檢查是否已在 API Proxy、機構或環境層級上傳特定 JAR 檔案。如果 JAR 檔案未上傳至任何層級,請前往「解決方法」。
  3. 如果已上傳 JAR 檔案,請參閱「原因:JAR 檔案已毀損」。

解析度

  1. 如果 JAR 檔案已損毀或部分上傳,請重建 JAR,然後在適當層級 (API Proxy、機構或環境層級) 上傳 JAR 檔案。
  2. 重新部署 API Proxy。

原因:JAR 檔案毀損

診斷

  1. 找出應該包含無法例項化的類別 (如上述步驟 1 所述) 的 JAR 檔案。
  2. 檢查特定 JAR 檔案是否已損毀。舉例來說,如果檔案已毀損或只上傳了一部分,您就無法解壓縮檔案。如果損毀,請參閱「解決方法」一節。
  3. 如果 JAR 檔案未損毀,請參閱「原因:缺少類別檔案」。

解析度

  1. 重建已損毀的 JAR 檔案,並在適當層級 (API Proxy、機構或環境層級) 上傳 JAR 檔案。
  2. 重新部署 API Proxy。

原因:缺少類別檔案

診斷

  1. 檢查特定的 Java 類別檔案 (如上述步驟 1 所述) 是否屬於 >ResourceURL< 中指定的 JAR 檔案,或任何依附 JAR 檔案。
  2. 如果任何 JAR 檔案中都沒有類別檔案,您就已找出錯誤原因。前往「解決方案」。
  3. 如果類別檔案存在於 JavaCallout 政策中指定的其中一個 JAR 檔案,則 Java 程式碼或依附元件類別一定有問題,才會導致這個錯誤。 a. 如果您是 Public Cloud 使用者,請與 Apigee 支援團隊聯絡。 b. 如果您是私有雲使用者,請前往「原因:Java 程式碼問題」。

解析度

  1. 使用缺少的類別檔案重建 JAR,然後在適當層級 (API Proxy、機構或環境層級) 上傳 JAR 檔案。
  2. 重新部署 API Proxy。

原因:Java 程式碼問題

僅適用於私有雲使用者的診斷步驟

診斷

  1. 檢查訊息處理器記錄 (/opt/apigee/var/log/edge-message-processor/system.log 和 /opt/apigee/var/log/edge-message-processor/configurations.log)。
  2. 您可能會看到類似下方的例外狀況:

    2019-07-05 05:40:13,240 org:myorg env:staging target:/organizations/myorg/apiproxies/MyAPI/revisions/5 action:add context-id: mode: Apigee-Main-53 ERROR CONFIG-CHANGE - AbstractConfigurator.add() : Add null to Step failed, reason: {}
    com.apigee.kernel.exceptions.spi.UncheckedException: Failed to instantiate the JavaCallout Class <class name>
    at com.apigee.steps.javacallout.JavaCalloutStepDefinition.newInstance(JavaCalloutStepDefinition.java:116)
    at com.apigee.messaging.runtime.StepDefinition.getStepDefinitionExecution(StepDefinition.java:218)
    …<snipped>
    Caused by: java.lang.reflect.InvocationTargetException: null
    at sun.reflect.NativeConstructorAccessorImpl.newInstance0(Native Method)
    at sun.reflect.NativeConstructorAccessorImpl.newInstance(NativeConstructorAccessorImpl.java:62)
    at com.apigee.steps.javacallout.JavaCalloutStepDefinition.access$100(JavaCalloutStepDefinition.java:41)
    at com.apigee.steps.javacallout.JavaCalloutStepDefinition$CallOutWrapper.initialize(JavaCalloutStepDefinition.java:131)
    at com.apigee.steps.javacallout.JavaCalloutStepDefinition$CallOutWrapper.<init>(JavaCalloutStepDefinition.java:126)
    ... 42 common frames omitted
    Caused by: <Reason>
    
    ...<snipped>
    
    
  3. 請仔細閱讀例外狀況,瞭解失敗原因。這通常表示 Java 程式碼有問題。

解析度

  1. 視失敗原因而定,您可能必須修正 Java 程式碼中的問題。
  2. 使用缺少的類別檔案重建 JAR,然後在適當層級 (API Proxy、機構或環境層級) 上傳 JAR 檔案。
  3. 重新部署 API Proxy。

上傳 JAR 檔案

確認 API Proxy、環境或機構層級中,存在具有所有必要類別的資源元素。詳情請參閱「資源檔案」。

  1. 如要在 API 代理層級上傳資源,請按一下「Resources」分頁中的「+」 (加號),然後選取「Import file」並從本機上傳檔案。檔案名稱應與 >ResourceURL< 元素相符,但不得包含 java:// 前置字串。

  2. 如要讓資源在同一環境中供多個 API Proxy 使用,請將資源上傳至該環境。您需要使用 Edge API,詳情請參閱「資源檔案」。

    舉例來說,從本機輸入下列 API 呼叫,即可在環境層級上傳指定檔案:

    curl -v -u email -H "Content-Type: application/octet-stream" \
    -X POST --data-binary @{classes.jar} \
    "http://{mgmt_server}:{port}/v1/organizations/myorg/environments/myenv/resourcefiles?name=myresouce.jar&type=java"
    

    從檔案所在的目錄發出 API 呼叫。

  3. 如要讓檔案可供機構中所有環境內的所有 API Proxy 使用,可以在基本路徑中省略環境詳細資料。例如:

    curl -v -u email -H "Content-Type: application/octet-stream" \
    -X POST --data-binary @{classes.jar} \
    "http://{mgmt_server}:{port}/v1/organizations/myorg/resourcefiles?name=myresouce.jar&type=java"