500 サーバーエラー - BadPath

<ph type="x-smartling-placeholder"></ph> 現在、Apigee Edge のドキュメントが表示されています。
Apigee X のドキュメント。 詳細

症状

クライアント アプリケーションは、次の HTTP ステータス コード 500 Internal Server Error を取得します。 API 呼び出しのレスポンスとしてエラーコード protocol.http.BadPath。

エラー メッセージ

クライアント アプリケーションが次のレスポンス コードを受け取ります。

HTTP/1.1 500 Internal Server Error

また、次のエラー メッセージが表示される場合があります。

{
   "fault":{
      "faultstring":"Invalid request path",
      "detail":{
         "errorcode":"protocol.http.BadPath"
      }
   }
}

考えられる原因

このエラーは、フロー変数で表されるバックエンド サーバーのリクエスト URL が target.url, 代わりに疑問符（?）で始まる path が含まれている スラッシュ（/）は無効です。

仕様に基づく <ph type="x-smartling-placeholder"></ph> RFC 3986 のセクション 3: Syntax Components と <ph type="x-smartling-placeholder"></ph> RFC 3986、セクション 3.3: Path:

1. URI の構文 には次のコンポーネントがあります。

           foo://example.com:8042/over/there?name=ferret#nose
           \_/   \______________/\_________/ \_________/ \__/
            |            |            |            |       |
         scheme      authority       path        query   fragment
   

2. path コンポーネントは必須で、先頭と末尾で指定する必要があります。 必ずスラッシュ（/）を付けます。

したがって、バックエンド サーバーのリクエスト URL に path コンポーネントが含まれている場合、 スラッシュ（/）ではなく疑問符（?）を使用した場合、Apigee Edge が 500 Internal Server Error とエラーコードを返す protocol.http.BadPath。

たとえば、target.url の値が https://www.mocktarget.apigee.net?json の場合、このエラーは path は疑問符で始まるため、無効である （?）をスラッシュ（/）の代わりに使用しないでください。

共通の診断手順

このエラーを診断するには、次のいずれかのツールまたは手法を使用します。

原因: バックエンド サーバーの URL（target.url）のパスが無効です

診断

1. API Monitoring、Trace ツール、または NGINX アクセスログを使用して、500 Internal Server Error の障害コードと障害ソースを特定します。詳しくは、 一般的な診断手順。
2. 障害コードが protocol.http.BadPath で、障害ソースが 値 target の場合は、バックエンド サーバーの URL に無効な URL が あります。

3. バックエンド サーバーの URL は、Apigee のフロー変数 target.url で表されます。 。このエラーは通常、バックエンド サーバーの URL を更新しようとした場合に発生します。 （target.url）動的に（ プロキシや共有フローなど）をターゲット リクエスト フローで処理し、無効なパスを持つようにします。

   <ph type="x-smartling-placeholder">

4. フロー変数 target.url に無効な値が含まれているかどうかを判定します。 path とその値のソースを、次のいずれかの方法で指定します。

   トレース

   Trace ツールの使用

   このエラーのトレースをキャプチャした場合は、 Trace ツールの使用 と

   1. target.url に無効なパスがあるかどうか、つまり、パスが始まっているかどうかを確認する スラッシュ（/）の代わりに疑問符（?）を使用する。

   2. 「はい」の場合、 target.url に無効なパスを含めます。

      JavaScript ポリシーがフロー変数を更新したことを示すサンプル トレース target.url

      
   3. 上記のサンプル トレースでは、JavaScript ポリシーによって、無効なパスを含むように target.url の値が変更または更新されています。
   4. target.url には次のコンポーネントがあります。 <ph type="x-smartling-placeholder">
      </ph>
      • スキーム: https
      • 認証機関: mocktarget.apigee.net
      • パス: ?json

      パスは前方ではなく疑問符（?）で始まっている スラッシュ（/） があるため、無効です。

   ログ

   ログサーバーでのログの使用

   1. このエラーのトレースがない場合（断続的に発生する問題）は、 フロー変数の値に関する情報がログに記録され、 target.url（次のようなポリシーを使用） <ph type="x-smartling-placeholder"></ph> MessageLogging または <ph type="x-smartling-placeholder"></ph> ServiceCallout ポリシーをログサーバーに追加します。
   2. ログがある場合は、それらを確認して <ph type="x-smartling-placeholder">
      </ph>
      1. target.url に無効なパスがあるかどうか確認します。また、
      2. 変更されたポリシーに関する情報を特定できるかどうかを確認する target.url: 無効なパスを含めます

   API プロキシ

   失敗した API プロキシの確認

   このエラーのトレースやログがない場合は、失敗した API を確認してください。 プロキシを使用して、フロー変数 target.url を変更または更新された内容を特定 無効なパスが含まれている可能性があります。次の点を確認してください。

   • API プロキシ内のポリシー
   • プロキシから呼び出される共有フロー

5. 変更または変更を行う特定のポリシー（AssignMessage や JavaScript など）を慎重に調査します。 フロー変数 target.url を更新し、 target.url を更新して無効なパスを指定する。

   フロー変数 target.url を更新するポリシーの例を次に示します。 誤って無効なパスが含まれていると、このエラーが発生します。

   サンプル 1

   サンプル 1: target.url 変数を更新する JavaScript ポリシー

   var url = "https://mocktarget.apigee.net?json"
   context.setVariable("target.url", url);

   上記のサンプルでは、フロー変数 target.url が更新されています。 値 https://mocktarget.apigee.net?json が別の 変数 url.

   url の値には次のコンポーネントが含まれます。

   • スキーム: https
   • 認証機関: mocktarget.apigee.net
   • パス: ?json

   パスはスラッシュではなく疑問符（?）で始まっている （/）は無効です。したがって、Apigee Edge は 500 Internal Server Error（エラーコード: protocol.http.BadPath）。

   サンプル 2

   サンプル 2: target.url 変数を更新する JavaScript ポリシー リクエスト ヘッダーの値に基づいて

   var path = context.getVariable("request.header.Path");
   var url = "https://mocktarget.apigee.net" + path
   context.setVariable("target.url", url);

   上記のサンプルでは、フロー変数 target.url が更新されています。 配列に含まれる値 https://mocktarget.apigee.net を連結して、 変数 url 、 別の変数 path の値、 値が request.header.Path. から取得される

   実際のリクエストまたはトレースにアクセスできる場合は、実際の値を検証できます。 request.header.Path に渡されます。

   ユーザーによるリクエストの例

   curl -v https://HOST_ALIAS/v1/myproxy -H "Authorization: Bearer <token> -H "Path: ?user"
   

   この例では、ヘッダーパスはリクエストの一部として送信されません。したがって、 JavaScript ポリシーの変数 path の値が null になっている。

   それによって次のようになります。

   • url = https://mocktarget.apigee.net + path
   • url = https://mocktarget.apigee.net + "?user"
   • target.url = https://mocktarget.apigee.net?user

   target.url の値には次のコンポーネントが含まれます。

   • スキーム: https
   • 認証機関: mocktarget.apigee.net
   • パス: ?user

   パスはスラッシュではなく疑問符（?）で始まっている （/）は無効です。したがって、Apigee Edge はエラーコード protocol.http.BadPath とともに 500 Internal Server Error を返します。

   サンプル 3

   サンプル 3: target.url 変数を更新する AssignMessage ポリシー

   <AssignMessage async="false" continueOnError="false" enabled="true" name="AM-SetTargetURL">
       <DisplayName>AM-SetTargetURL</DisplayName>
       <AssignVariable>
            <Name>target.url</Name>
            <Value>https://mocktarget.apigee.net?echo</Value>
       </AssignVariable>
       <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
       <AssignTo createNew="false" transport="http" type="request"/>
   </AssignMessage>

   url の値には次のコンポーネントがあります。

   • スキーム: https
   • 認証機関: mocktarget.apigee.net
   • パス: ?echo

   この例でも、パスは疑問符（?）で始まります。 スラッシュ（/）の代わりに使用してください。これは無効です。したがって、 Apigee Edge がエラーコードとともに 500 Internal Server Error を返す protocol.http.BadPath。

解決策

URL 仕様に従う <ph type="x-smartling-placeholder"></ph> RFC 3986、セクション 3: Syntax Components では、path コンポーネントが必須です。 また、先頭は常に「"/」で始める必要があります。次の手順に沿って問題を解決してください。

1. フロー変数で表されるバックエンド サーバーの URL を確認する target.url には常に有効なパスがあり、常に スラッシュ（/）。 <ph type="x-smartling-placeholder">
   </ph>
   1. パスにリソース名が存在しない場合は、 少なくともスラッシュ（/）がある。
   2. 他の変数を使用してフロー変数の値を決定する場合 target.url。次に、他の変数に 無効なパスです。
   3. フロー変数の値を決定する文字列オペレーションを実行する場合 target.url の場合は、文字列の結果または結果が 無効なパスがないことを確認します。

2. 上記のサンプルでは、この問題を解決できます。手順は次のとおりです。

   サンプル 1

   サンプル 1: target.url 変数を更新する JavaScript ポリシー

   疑問符（?）の代わりにスラッシュ（/）を 次のように変数 url を使用して、この問題を修正します。

   var url = "https://mocktarget.apigee.net/json"
   context.setVariable("target.url", url);

   サンプル 2

   サンプル 2: target.url 変数を更新する JavaScript ポリシー リクエスト ヘッダーの値に基づいて

   var path = context.getVariable("request.header.Path");
   var url = "https://mocktarget.apigee.net" + path
   context.setVariable("target.url", url);

   リクエストの一部として有効なパス（例: /user）を渡すようにします。 次のように、ヘッダー Path でこの問題を修正します。

   リクエストの例:

   curl -v https://HOST_ALIAS/v1/myproxy -H "Authorization: Bearer <token> -H "Path: /user"
   

   サンプル 3

   サンプル 3: target.url 変数を更新する AssignMessage ポリシー

   AssignMessage ポリシーの <Value> 要素に有効なパスを追加します。 つまり、疑問符（?）を <Value> 要素内のスラッシュ（/） この問題を解決するには、次のように https://mocktarget.apigee.net/echo に設定します。

   <AssignMessage async="false" continueOnError="false" enabled="true" name="AM-SetTargetURL">
       <DisplayName>AM-SetTargetURL</DisplayName>
       <AssignVariable>
            <Name>target.url</Name>
            <Value>https://mocktarget.apigee.net/echo</Value>
       </AssignVariable>
       <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
       <AssignTo createNew="false" transport="http" type="request"/>
   </AssignMessage>

   仕様

   Apigee Edge では、バックエンド サーバー URL の path コンポーネント が 次に示すように、必ず スラッシュ（/） で始めなければなりません。 仕様:

   仕様
   <ph type="x-smartling-placeholder"></ph> RFC 3986、セクション 3: Syntax Components
   <ph type="x-smartling-placeholder"></ph> RFC 3986、セクション 3.3: Path

   Apigee サポートのサポートが必要な場合は、 診断情報をご覧ください。

   診断情報の収集が必要な場合

   上記の手順でも問題が解決しない場合は、以下の情報を収集します。 Apigee Edge サポートにお問い合わせください。

   Public Cloud ユーザーの場合は、次の情報を提供します。

   • 組織名
   • 環境名
   • API プロキシの名前
   • エラーコード protocol.http.BadPath とともに 500 Internal Server Error を再現するために使用する curl コマンドを完成させる
   • API リクエストのトレース ファイル

   Private Cloud ユーザーの場合は、次の情報を提供します。

   • 失敗したリクエストについて観測された完全なエラー メッセージ
   • 環境名
   • API プロキシ バンドル
   • API リクエストのトレース ファイル

   • NGINX アクセスログ:

     /opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log

     ここで、ORG、ENV、PORT# は、 使用します。

   • Message Processor システムログ /opt/apigee/var/log/edge-message- processor/logs/system.log

   参照

   フロー変数 - ターゲット