为什么reCAPTCHA v3触发后无法提交我的反馈表单？

故障原因 #

• 代码存在两个事件绑定冲突：表单onsubmit属性和reCaptcha按钮的data-callback同时绑定了submitContactForm函数，onsubmit中传入的token是未定义变量，此前浏览器对该错误容错性高未中断执行，近期reCaptcha规则或浏览器JS解析逻辑更新后，该错误触发执行中断，导致回调不触发。
• 若你后续调整过JS代码结构，submitContactForm函数可能不再处于全局作用域，reCaptcha要求回调函数必须挂载在window对象下才能被调用，作用域不匹配会导致回调静默失败。
• 部分情况下reCaptcha后台站点密钥配置变更（比如新增域名校验、密钥过期）也会导致验证通过后不触发回调。

修复步骤 #

1. 移除form标签上冗余的onsubmit属性，修改后的form标签代码如下：

<form id="contact-form" 
      action="/" 
      method="post" 
      enctype="multipart/form-data"
>

2. 调整JS代码，确保回调函数暴露在全局作用域，同时添加参数校验避免异常：

// 直接挂载到window对象，确保reCaptcha可以访问到
window.submitContactForm = function(token) {
    // 可自行添加调试日志确认回调是否触发
    if (token) {
        document.getElementById('contact-form').submit();
    }
}

3. 额外校验项：

• 确认当前站点域名在reCaptcha后台的允许域名列表中，站点密钥和后台配置完全一致
• 打开浏览器开发者工具控制台，点击提交按钮后查看是否有JS报错，排除其他第三方代码冲突问题

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