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

您正在查看 Apigee Edge 說明文件。
前往 Apigee X 說明文件。info

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 中，所有「流程標示」政策。檢查是否有任何「流程快訊」政策，其中 <SharedFlowBundle> 元素使用上述步驟 1 中指定的流程名稱。

    舉例來說，下列政策會將 <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 中，檢查「API」>「Shared Flows」下方是否有這個共用流程。如果不是，就是發生錯誤的原因。(請注意，在 New Edge UI 中，您可以在「Develop」分頁下方找到「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 呼叫，就不會再看到錯誤，因為 Flow 說明文字也會部署至測試環境。

原因：未部署共用流程

如果未部署在「流程說明」政策的 <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

解析度

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

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

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