流程呼叫政策執行階段錯誤疑難排解

查看 Apigee Edge 說明文件。
前往 Apigee X說明文件
資訊

SharedFlowNotFound

錯誤代碼

flow.SharedFlowNotFound

錯誤回應主體

{
    "fault": {
        "faultstring": "Shared Flow shared_flow_name Not Found",
        "detail": {
            "errorcode": "flow.SharedFlowNotFound"
        }
    }
}

可能原因

導致這項錯誤的可能原因包括:

原因 說明
無法使用共用流程 共用的流程不存在。
未部署共用流程 已有共用流程,但尚未部署。

原因:無法使用共用流程

在流程呼叫政策中,如果 <SharedFlowBundle> 元素中定義的共用流程不存在於環境中,就會發生這個錯誤。

舉例來說,如果資料流呼叫政策中的 <SharedFlowBundle> 元素包含名為 SharedFlow_Sample 的共用流程,而且環境中不存在這個共用流程,就會發生錯誤。

錯誤訊息範例

{
    "fault": {
        "faultstring": "Shared Flow SharedFlow_Sample Not Found",
        "detail": {
            "errorcode": "flow.SharedFlowNotFound"
        }
    }
}

診斷

  1. 識別不存在的共用流程。您可以在錯誤回應的 faultstring 元素中找到這項資訊。例如,下列 faultstring 中的共用流程名稱為 SharedFlow_Sample

    "faultstring": "Shared Flow SharedFlow_Sample Not Found"

  2. 檢查發生錯誤時,特定 API Proxy 中的所有流程呼叫政策。檢查是否有任何流程呼叫政策 (指定在上方步驟 1 中識別的流程名稱) 為 <SharedFlowBundle> 元素指定政策。

    舉例來說,下列政策會將 <SharedFlowBundle> 指定為 SharedFlow_Sample,與錯誤字串中的內容相符。

    <FlowCallout async="false" continueOnError="false" enabled="true" name="Auth-Flow-Callout">
       <DisplayName>Auth Flow Callout</DisplayName>
       <SharedFlowBundle>SharedFlow_Sample</SharedFlowBundle>
    </FlowCallout>
    
  3. 在 Edge UI 中,檢查「APIs」(API) > 下是否有這個共用流程Shared Flows。如果不是,就是發生錯誤的原因。(請注意,在新版 Edge UI 的「Development」分頁下會顯示「Shared Flows」)。

    例如,在下方螢幕截圖中,共用流程 SharedFlow_Sample 不存在。

    這個共用流程不存在,您會收到錯誤代碼:

    flow.SharedFlowNotFound
    

解析度

請確認在流程說明政策的 <SharedFlowBundle> 元素中指定的共用流程,是否已在執行 API 要求的特定環境中部署。

您可以選擇下列任一方式解決問題:

  1. 建立名為 SharedFlow_Sample 的共用流程,如下所示,並將其部署至測試環境,如下所示:

  2. 在「流程呼叫」政策中,使用部署於測試環境中的現有共用流程。舉例來說,您可以在流程呼叫政策中指定 SharedFlow_demo

    <FlowCallout async="false" continueOnError="false" enabled="true" name="Auth-Flow-Callout">
      <DisplayName>Auth Flow Callout</DisplayName>
      <SharedFlowBundle>SharedFlow_demo</SharedFlowBundle>
    </FlowCallout>
    

    如果您向測試環境發出 API 呼叫, 發生錯誤,因為流程呼叫已一併部署至測試環境。

原因:未部署共用流程

如果未部署在「流程說明」政策的 <SharedFlowBundle> 元素中指定的共用流程,就會發生這個錯誤。

舉例來說,如果「流程標示」政策中的 <SharedFlowBundle> 元素包含名為 SharedFlow_example 的共用流程,但該流程並未部署在 API 要求的特定環境中,就會發生錯誤。

錯誤訊息範例

{
    "fault": {
        "faultstring": "Shared Flow Shared-Flow_example Not Found",
        "detail": {
            "errorcode": "flow.SharedFlowNotFound"
        }
    }
}

診斷

  1. 識別未部署的共用流程。您可以在錯誤回應的 faultstring 元素中找到這個值。例如,下列 faultstring 中的共用流程名稱為 Shared-Flow_example

    "faultstring": "Shared Flow Shared-Flow_example Not Found"

  2. 在 Edge UI 中,檢查這個共用流程是否已部署完成。

    例如,您會看到在下方的螢幕截圖中,有共用流程 SharedFlow_example 但尚未部署

    由於未部署這項共用流程,因此您會收到以下錯誤代碼:

    flow.SharedFlowNotFound
    

解析度

確保在執行 API 要求的特定環境中,存在於 <SharedFlowBundle> 元素中指定的共用流程並部署在執行 API 要求的特定環境中。

如要修正上述範例,請在測試環境中部署名為 SharedFlow_example 的共用流程,如下所示:

如果您對測試環境發出 API 呼叫,就不會再看到錯誤,因為 Flow 說明文字也會部署至測試環境。