reCaptcha Enterprise报错：[object Map Iterator]非可迭代对象求助

问题详情 #

使用reCaptcha Enterprise时，偶尔会触发未捕获错误，错误信息如下：

Uncaught Error: [object Map Iterator] is not an iterable or ArrayLike
    at Array.<anonymous> (recaptcha__pl.js:54:342)
    at n1.<anonymous> (recaptcha__pl.js:207:290)
    at Qy (recaptcha__pl.js:596:338)
    at L (recaptcha__pl.js:229:168)

已尝试更换多个reCaptcha站点密钥、调整脚本在页面中的放置位置，问题仍未解决。

当前页面中引入reCaptcha的代码（放置在body标签内）：

<script src="https://www.google.com/recaptcha/enterprise.js?onload=myCallBack&render=explicit" async defer></script>

回调函数代码：

recaptcha = grecaptcha.enterprise.render('recaptcha', {
    'sitekey': '${sitekey}'
});

补充信息 #

• 报错时，reCaptcha组件区域会显示错误提示（界面呈现异常状态，提示用户出错需重试）
• 错误为随机触发，多次刷新页面后可能出现，但无固定复现规律
• 调试时捕获到reCaptcha内部代码片段，显示其尝试对Map迭代器执行类似数组的操作，因环境不兼容导致报错

修复建议 #

1. 检查浏览器兼容性
   这个错误通常源于运行环境不支持Map Iterator的可迭代特性，比如部分老旧浏览器（如Chrome 50以下、Safari 10以下）。确认用户使用的浏览器版本符合reCaptcha Enterprise的官方兼容要求，建议强制用户升级到现代浏览器。

2. 避免重复渲染
   排查页面是否存在多次调用grecaptcha.enterprise.render的情况，比如页面刷新时重复初始化，导致内部Map状态紊乱。可以在回调函数中添加判断逻辑，确保只渲染一次：

let recaptchaInstance = null;
function myCallBack() {
    if (!recaptchaInstance) {
        recaptchaInstance = grecaptcha.enterprise.render('recaptcha', {
            'sitekey': '${sitekey}'
        });
    }
}

3. 切换为自动渲染模式
   尝试去掉显式渲染的配置，改用自动渲染：

• 删除脚本中的onload=myCallBack&render=explicit参数
• 在reCaptcha容器元素上添加data-sitekey属性：

<div id="recaptcha" data-sitekey="${sitekey}"></div>
<script src="https://www.google.com/recaptcha/enterprise.js" async defer></script>

这种方式由Google脚本自动处理渲染时序，减少手动回调可能带来的状态异常。

4. 添加全局错误捕获
   在页面中添加全局错误监听，避免报错阻断页面逻辑，同时收集更多上下文信息用于排查：

window.addEventListener('error', (event) => {
    if (event.message.includes('[object Map Iterator]')) {
        // 记录报错时的用户代理、页面状态等信息
        console.error('reCaptcha报错详情:', event, navigator.userAgent);
        // 可选：尝试重新渲染reCaptcha
        if (recaptchaInstance) {
            grecaptcha.enterprise.reset(recaptchaInstance);
        }
    }
});

5. 联系Google官方支持
   如果以上方法均无效，大概率是reCaptcha Enterprise脚本自身的兼容性bug。提交工单给Google支持团队，提供错误栈信息、浏览器版本、复现场景（比如是否在特定设备/浏览器下更容易触发），请求官方排查修复。

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