如何在Google reCAPTCHA未成功验证时阻止提交输入数据
核心认知校准
首先明确grecaptcha.getResponse()的官方返回规则,该接口不存在可读取的success属性:
- 页面初始加载、验证码流程未完成、校验被判定为非人类操作时,固定返回空字符串
- 验证码通过全流程校验时,返回一次性加密验证令牌(也就是观察到的、每次页面加载后内容不同的长字符串)
之前代码中读取rc.success得到undefined,本质是混淆了前后端接口的返回结构:success字段是后端将令牌提交到Google服务完成校验后才会返回的结果,前端获取令牌的接口本身不会携带这个字段。
前端提交拦截实现方案
基础拦截逻辑
在提交事件触发时,通过判断令牌是否为空字符串实现拦截,无需额外的状态判断:
$('#btn').on('click', function(e){ // 获取前端侧的验证码响应 const recaptchaToken = grecaptcha.getResponse(); // 无有效令牌时直接阻断提交流程 if (!recaptchaToken) { alert('请先完成验证码校验'); e.preventDefault(); return false; } // 后续执行输入框取值校验、接口提交逻辑 // 提交时需将recaptchaToken一并传给后端做二次校验 })
体验优化方案
可以借助reCAPTCHA自带的回调机制,在校验完成前直接禁用提交按钮,减少无效点击:
- 按照规范引入验证码资源、配置容器属性
<script src="https://www.google.com/recaptcha/api.js" async defer></script> <div class="g-recaptcha" data-sitekey="6Lf-wAIaAAAAALa36iP4tIvwCeub0-bAB3QfqWbP" data-callback="onRecaptchaVerified" ></div> <button id="btn" disabled>提交</button>
- 实现全局回调方法控制按钮状态
// 验证码校验通过后自动触发的回调 function onRecaptchaVerified() { // 仅在校验通过后放开提交按钮 document.getElementById('btn').disabled = false; }
关键注意事项
- 前端侧的空值判断仅作为体验优化手段,不能作为最终校验依据
- 最终的有效性校验必须由后端完成:将前端传回的令牌提交到Google验证接口,根据接口返回的
success字段判断是否允许接收提交的内容,避免前端逻辑被篡改绕过校验 - 校验完成后的令牌有有效期限制,且只能使用一次,提交后需要调用
grecaptcha.reset()重置验证码状态,避免重复提交带来的校验问题
内容的提问来源于stack exchange,提问作者qadenza
相关产品推荐
相关产品推荐

