Magento 2 Google隐形reCAPTCHA v3偶发故障致部分用户无法注册

已确认的问题与排查结果 #

• 故障现象：部分用户完成注册时触发reCAPTCHA报错，提示内容：

Something went wrong with reCAPTCHA. Please contact the store owner.

• 排查验证：
  • 排除浏览器因素：通过远程连接用户设备测试，问题依然复现，排除浏览器版本、缓存等本地环境问题
  • 根因锁定：禁用Magento后台「安全设置」中注册环节的reCAPTCHA后，注册流程恢复正常，确认故障由reCAPTCHA v3模块导致

可行的排查与修复方向 #

• 核对reCAPTCHA密钥配置：登录Google reCAPTCHA管理控制台，确认Site Key和Secret Key处于有效状态，且域名白名单已正确添加站点的所有访问域名（需覆盖HTTP/HTTPS、带www/不带www的不同域名形式）
• 调整评分阈值：在Magento后台的reCAPTCHA设置中，适当降低v3版本的评分阈值（默认值为0.5）。部分用户可能因行为特征（如操作过快、IP归属地等）被判定为低风险评分，触发拦截
• 检查区域服务可用性：确认用户所在地区的Google reCAPTCHA服务是否稳定，部分地区可能存在网络访问波动导致的偶发故障
• 排查扩展冲突：临时禁用其他安全类、表单类Magento扩展，逐一排查是否存在与reCAPTCHA模块的交互冲突
• 启用日志排查：在Magento后台开启reCAPTCHA的日志记录功能，获取故障触发时的具体错误日志，进一步定位问题节点

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