排解 reCAPTCHA 整合問題

本文列出開發人員在環境中使用 reCAPTCHA 時，可能遇到的常見 reCAPTCHA 整合問題。

網站金鑰或金鑰類型無效

如果看到 Invalid site key 或 Invalid key type 錯誤，請檢查下列事項：

金鑰遷移失敗

在下列情況下，網站金鑰可能無法遷移：

  • 您或貴組織建立的專案數量已超過上限。

    如要解決這個問題，請重複使用現有專案、要求提高專案建立配額，或是等待自動遷移作業完成。

  • 您的 Workspace 組織已限制建立新的 Google Cloud專案。

    如要在 Google 管理控制台中開啟 Google Cloud 服務，請與管理員聯絡。詳情請參閱「為使用者開啟或關閉 Google Cloud 」。

SecurityError: blocked a frame with origin "https://www.google.com" from accessing a frame with origin "&ltyour domain&gt"

這種情況通常發生在使用者點選核取方塊後，reCAPTCHA 小工具 HTML 元素遭到程式輔助移除。建議您使用 grecaptcha.enterprise.reset() JavaScript 函式重設 reCAPTCHA 小工具。

Localhost 不在支援的網域清單中

根據預設，系統不支援 localhost 網域。如要繼續支援這些網域進行開發，可以將其加入網站金鑰的支援網域清單。請前往Google Cloud 控制台更新支援的網域清單。建議您在開發和正式環境中使用不同的金鑰，並只在開發網站金鑰上允許 localhost。

建立評估時，reCAPTCHA 傳回 BROWSER_ERROR

如果 reCAPTCHA 指令碼無法執行 execute 作業，就會產生 BROWSER_ERROR 權杖。在多數情況下，這是因為用戶端網路故障或逾時。您必須使用 JavaScript 重試 execute()。