このページは Cloud Translation API によって翻訳されました。

ペイロードのラップ解除のトラブルシューティング

このページでは、ペイロードのアンラッピングに関する問題を解決する方法について説明します。

HTTP ステータスコードエラー

ペイロードのラップ解除を使用すると、一般的な HTTP ステータスコードのエラーが発生する場合があります。エラーは push_request_count 指標でモニタリングできます。

構成ミスやデータの欠落が原因で Pub/Sub がリクエストを処理できない場合に、次のエラーが発生します。

400 Bad Request

この問題は、いくつかの原因で発生します。このエラーの最も一般的な原因は次のとおりです。

この問題を解決するには、次のことを試してください。

ペイロード（メッセージデータ）の形式を確認します。HTTP エンドポイントで指定された想定されるリクエスト形式と一致していることを確認します。
リクエストに必要なヘッダーが含まれていることを確認します。ヘッダーがない場合は、メッセージ属性に追加する必要があります。例には Content-Type を含まれる場合がありますが、その他が必要となる場合もあります。
サブスクリプションに構成されている HTTP エンドポイントが有効であることを確認します。
プッシュサブスクリプションでデッドレターキュー（DLQ）を有効にします。これにより、配信できない個々のメッセージがリダイレクトされます。検査する 400 エラーが少数ある場合は、DLQ を有効にすることをおすすめします。

認証情報が正しくないか無効であるために Pub/Sub がリクエストを処理できない場合に、次のエラーが発生します。

401 unauthorized / 403 forbidden

このエラーは、プッシュサブスクリプションが認証されていない場合に発生します。

この問題を解決するには、次のことを試してください。

[プッシュ認証] を有効にします。Cloud Run または App Engine と統合する場合は、Push 認証を使用することが重要です。

ソリューションで push 認証が機能しない場合は、publish message 属性に独自の認証キーまたは API キーを追加する必要があります。

ペイロードの形式がサポートされていない形式であるために Pub/Sub がリクエストを処理できない場合、次のエラーが発生します。

415 Unsupported Media Type

この問題は、いくつかの原因で発生します。このエラーの最も一般的な原因は次のとおりです。

この問題を解決するには、次のことを試してください。

エンドポイントには Content-Type ヘッダーが必要である可能性があります。デフォルトでは、ペイロードのラップ解除によってメディアタイプヘッダーが設定されることはありません。Content-Type ヘッダーは、publish message 属性としてアタッチすることで設定できます。

リクエストで送信されたコンテンツが大きすぎるために Pub/Sub がリクエストを処理できない場合に、次のエラーが発生します。

431 request header fields too Large / 413 content too large

これらの問題を解決するには、次のソリューションを試してください。

[メタデータを書き込む] をオフにします。
プッシュサブスクリプションでデッドレターキュー（DLQ）を有効にします。これにより、配信できない個々のメッセージがリダイレクトされます。その後、サブスクリプションは引き続き機能しますが、エラーのあるメッセージは別のトピックにリダイレクトされ、さらに分析されます。

Google Cloud コンソールで [サブスクリプション] ページに移動します。

Pub/Sub サブスクリプションを開く
サービスの名前をクリックします。

サービスの詳細ページが開きます。
構成テーブルで、メッセージデータのラップ解除とメッセージメタデータの書き込みの値を確認します。

ペイロードのラップのステータス（有効または無効）が、対応するテーブル行に表示されます。