排解 reCAPTCHA 整合問題

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

網站金鑰無效

如果看到 Invalid site key 錯誤，表示 reCAPTCHA 網站金鑰已失效。建立新金鑰，然後在網頁上安裝。

金鑰遷移失敗

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

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

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

  • 您的工作區機構已限制建立新專案。 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 小工具。

本機主機不在支援的網域清單中

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

建立評估時，reCAPTCHA 傳回 BROWSER_ERROR

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