Joomla站点ReCAPTCHA v3执行报错，无法生成有效Token求助

问题背景 #

Joomla站点内部分表单配置ReCAPTCHA v3验证时，无法生成有效令牌，执行以下代码在Joomla环境外正常，但站内报错：

grecaptcha.execute("SECRET_KEY", {action: 'submit'}).then(function(token){
    console.log(token);
});

排查与解决步骤 #

• 修正密钥使用错误
  前端执行grecaptcha.execute必须使用Site Key，而非后端验证用的Secret Key。你代码里的"SECRET_KEY"大概率填错了，替换为Google ReCAPTCHA控制台生成的Site Key即可。

• 检查ReCAPTCHA插件配置
  确认Joomla后台的「Captcha - reCAPTCHA」插件已启用，版本选择v3，且插件内配置的Site Key、Secret Key与Google控制台一致，action参数需和插件设置匹配。

• 排查JS加载冲突

  • 打开浏览器控制台（F12），查看是否有grecaptcha is not defined类报错，确认ReCAPTCHA脚本<script src="https://www.google.com/recaptcha/api.js?render=你的Site Key"></script>在执行代码前加载，且仅加载一次。
  • 临时禁用Joomla自带的jQuery冲突处理（如jQuery.noConflict()），测试是否因JS库冲突导致问题。

• 检查内容安全策略（CSP）
  部分模板或安全插件会设置CSP规则，阻止加载Google资源。确保CSP允许https://www.google.com、https://www.gstatic.com的资源加载，同时允许grecaptcha相关脚本执行。

• 清空缓存与排查扩展冲突

  • 清空Joomla后台的系统缓存，避免旧缓存文件干扰。
  • 临时禁用第三方表单、安全类扩展，逐个测试是否有扩展干扰ReCAPTCHA执行。

• 验证域名绑定
  登录Google ReCAPTCHA控制台，确认绑定的站点域名与当前Joomla运行域名完全一致（包括www/非www、http/https区别），域名不匹配会导致Google拒绝生成令牌。

内容的提问来源于stack exchange，提问作者connor lock