如何检测触发Google Auth 403 disallowed_useragent的用户代理？

核心思路 #

Google的disallowed_useragent错误针对的是嵌入式WebView环境，这类环境的User Agent（UA）通常带有特定标识。我们可以通过解析浏览器的UA字符串，识别出被禁用的WebView特征，提前给用户显示引导提示，避免登录失败。

常见禁用WebView的UA特征 #

• Facebook Messenger WebView：UA中包含FBAN/Messenger、FB_IAB/FB4A、MessengerForAndroid或MessengerForiOS等关键词
• 其他常见禁用WebView：比如微信的MicroMessenger（可根据实际用户反馈补充）

前端检测实现代码 #

在登录入口页面添加以下脚本，提前完成检测与引导：

// 检测是否为Google禁用的嵌入式WebView
function isDisallowedWebView() {
    const userAgent = navigator.userAgent.toLowerCase();
    // 匹配Facebook Messenger WebView特征
    const messengerPattern = /fban\/messenger|fb_iab\/fb4a|messengerforandroid|messengerforios/;
    // 如需添加其他禁用WebView，可追加正则，比如：
    // const wechatPattern = /micromessenger/;
    // return messengerPattern.test(userAgent) || wechatPattern.test(userAgent);
    return messengerPattern.test(userAgent);
}

// 页面加载时执行检测
window.addEventListener('load', function() {
    if (isDisallowedWebView()) {
        // 隐藏登录入口，显示引导提示
        const loginBtn = document.getElementById('login-btn');
        if (loginBtn) loginBtn.style.display = 'none';
        
        const tipElement = document.createElement('div');
        tipElement.style.padding = '1rem';
        tipElement.style.backgroundColor = '#fff3cd';
        tipElement.style.border = '1px solid #ffeeba';
        tipElement.textContent = '当前环境无法完成登录，请使用系统默认浏览器（如Chrome、Safari）打开本网站后再尝试操作。';
        document.body.appendChild(tipElement);
    }
});

补充说明 #

1. 合规性：该方案完全符合Google政策，未绕过限制，仅通过提前检测引导用户使用合规环境
2. UA特征更新：若后续出现新的禁用WebView案例，可根据用户反馈补充对应的UA特征到检测逻辑中
3. 非JS方案适配：如果无法使用前端JS，也可以在后端解析请求的User-Agent请求头，返回对应的提示页面或内容

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