Node.js网站Google OAuth登录遇Error 403: disallowed_useragent问题求助

问题根源 #

这个错误是Google OAuth系统将请求的用户代理（User-Agent）判定为不允许的嵌入式浏览器/WebView导致的。macOS下Edge浏览器切换到移动端模拟尺寸时，生成的User-Agent字符串包含了触发Google拦截规则的标识；而Windows或iOS平台的Edge无此问题，是因为不同平台的移动端模拟User-Agent格式存在差异。

解决方案 #

1. 确认Google OAuth客户端类型正确

登录Google Cloud Console，进入你的项目：

• 打开「API和服务」→「凭据」页面
• 找到当前使用的OAuth 2.0客户端ID，确保它是Web应用类型（而非Android、iOS或其他类型）
• 若之前创建的是其他类型，删除旧客户端并重新创建Web应用类型的客户端，同步更新passport配置中的clientID和clientSecret

2. 验证passport-google-oauth20配置规范

确保你的passport Google策略配置符合标准流程：

const GoogleStrategy = require('passport-google-oauth20').Strategy;

passport.use(new GoogleStrategy({
    clientID: YOUR_CLIENT_ID,
    clientSecret: YOUR_CLIENT_SECRET,
    callbackURL: "https://www.uvvo.eu/auth/google/callback" // 必须与Cloud Console中配置的回调URL完全一致
  },
  function(accessToken, refreshToken, profile, cb) {
    // 自定义用户处理逻辑
    User.findOrCreate({ googleId: profile.id }, function (err, user) {
      return cb(err, user);
    });
  }
));

• 确认callbackURL和Google Cloud Console中配置的授权回调URL完全匹配（包括协议、域名、路径）
• 确保使用默认的授权码流程（passport-google-oauth20默认采用，不要手动切换到隐含流程）

3. 更新Edge浏览器到最新版本

你当前使用的Edge v106属于旧版本，微软可能已修复移动端模拟模式下的User-Agent生成问题。更新到最新版Edge后，重新测试移动端尺寸下的登录功能，大概率能解决误判问题。

4. 临时修复：调整请求的User-Agent（仅用于测试）

若更新浏览器后问题仍存在，可通过中间件临时修改请求的User-Agent，避免被Google误判：

app.use('/auth/google', (req, res, next) => {
  // 替换移动端模拟时的User-Agent为桌面版Edge标识
  if (req.headers['user-agent']?.includes('Edg/106.0.1370.52') && req.headers['user-agent']?.includes('Mobile')) {
    req.headers['user-agent'] = 'Mozilla/5.0 (Macintosh; Intel Mac OS X 13_0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/106.0.0.0 Safari/537.36 Edg/106.0.1370.52';
  }
  next();
});

注意：这是临时方案，不建议长期使用，优先通过更新浏览器或调整Google配置解决问题。

5. 检查OAuth同意屏幕配置

在Google Cloud Console的「OAuth同意屏幕」页面：

• 确保应用类型为「外部」（如果是面向公众的网站）
• 完成必要的应用信息填写和验证（未验证的应用可能会触发更严格的访问限制）

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