reCAPTCHA Enterprise致Moodle网站登录锁定，配置后遇认证失败求助

紧急解锁：跳过reCAPTCHA登录验证 #

因为后台无法访问，直接通过数据库修改配置：

• 登录你的Moodle数据库管理工具（比如phpMyAdmin、Navicat）
• 执行以下SQL语句禁用reCAPTCHA插件并清空密钥：

  -- 禁用reCAPTCHA插件
  UPDATE mdl_plugins SET enabled = 0 WHERE name = 'recaptcha';
  -- 清空公钥
  UPDATE mdl_config SET value = '' WHERE name = 'recaptchapublickey';
  -- 清空私钥
  UPDATE mdl_config SET value = '' WHERE name = 'recaptchasecretkey';
  -- 关闭登录页reCAPTCHA验证（如果该配置项存在）
  UPDATE mdl_config SET value = 0 WHERE name = 'recaptchalogin';
  

• 清理Moodle缓存：
  • 手动删除Moodle安装目录下data/cache文件夹内的所有文件
  • 或者通过服务器命令行执行：php admin/cli/purge_caches.php（需确保PHP环境可执行）

重新正确配置reCAPTCHA #

解锁后登录后台，按以下步骤重新配置：

• 前往Google reCAPTCHA控制台，创建**reCAPTCHA v2（"I'm not a robot"复选框）**类型的密钥（v3密钥可能与部分Moodle版本不兼容，引发"invalid key type"错误）
• 域名设置中添加你的主域名和登录页子域名（如果有），支持通配符如*.example.com（注意安全风险）
• 在Moodle后台依次填写公钥、私钥，保存后再启用reCAPTCHA登录验证，避免先启用再填密钥导致的配置异常

排查初始"invalid key type"错误的原因 #

• 确认密钥类型：Moodle部分旧版本仅支持reCAPTCHA v2，若使用v3密钥会直接触发该错误
• 检查域名匹配：即使关闭域名验证，部分情况下Google仍会校验密钥与请求域名的关联，确保控制台中域名列表包含你的网站域名

内容的提问来源于stack exchange，提问作者Stacy Just