reCAPTCHA の統合に関する問題のトラブルシューティング

このドキュメントでは、環境で reCAPTCHA を使用するときにデベロッパーが遭遇する可能性のある一般的な reCAPTCHA 統合の問題を一覧表示します。

サイトキーが無効です

Invalid site key エラーが表示された場合は、reCAPTCHA サイトキーが無効になっています。新しいキーを作成して、ウェブページにインストールします。

鍵の移行の失敗

サイトキーは、次のいずれかのシナリオで移行に失敗する可能性があります。

SecurityError: 送信元「https://www.google.com」のフレームが、送信元「&ltyour domain&gt」のフレームにアクセスするのをブロックしました

これは通常、エンドユーザーがチェックボックスをクリックした後に、reCAPTCHA ウィジェットの HTML 要素がプログラムで削除された場合に発生します。reCAPTCHA ウィジェットをリセットするには、grecaptcha.enterprise.reset() JavaScript 関数を使用することをおすすめします。

localhost がサポートされているドメインのリストに含まれていない

localhost ドメインはデフォルトではサポートされていません。開発用に引き続きサポートする場合は、サイトキーのサポート対象ドメインのリストに追加できます。Google Cloud コンソールに移動して、サポートされているドメインのリストを更新します。開発環境と本番環境で別々のキーを使用し、開発サイトのキーでは localhost のみを許可することをおすすめします。

reCAPTCHA は評価の作成時に BROWSER_ERROR を返しました

BROWSER_ERROR トークンは、reCAPTCHA スクリプトが execute オペレーションを実行できない場合に発生します。ほとんどの場合、これはクライアント サイトのネットワーク障害やタイムアウトが原因です。JavaScript を使用して execute() を再試行する必要があります。