Node.js中Passport Google Auth获取RefreshToken失败问题排查

你代码里已经配置了accessType: "offline"和prompt: "consent"这两个关键参数，但仍无法获取refreshToken，可能是以下几个原因：

• 参数顺序或版本兼容问题
  部分版本的passport-google-oauth20策略，verify回调函数会多一个params参数（包含令牌过期时间等信息），正确的参数顺序应为(accessToken, refreshToken, params, profile, done)。如果你的包版本属于这种情况，当前代码里的profile变量实际是params，可以先打印所有参数确认：

  function (accessToken, refreshToken, params, profile, done) {
    console.log("refreshToken:", refreshToken);
    console.log("params:", params);
    return done(null, accessToken);
  }
  

• 未完全触发重新授权
  即使设置了prompt: "consent"，如果用户之前已经授权过你的应用，Google可能不会重复返回refreshToken。可以尝试：

  • 完全退出Google账号后重新发起授权流程
  • 将prompt值改为"select_account consent"，确保每次都弹出账号选择和授权确认页面

• passReqToCallback配置未启用
  取消注释passReqToCallback: true，并调整回调函数的第一个参数为req，某些场景下这个配置会影响令牌的返回逻辑：

  passReqToCallback: true,
  // 回调函数对应调整
  function (req, accessToken, refreshToken, profile, done) {
    console.log(refreshToken);
    return done(null, accessToken);
  }
  

• 依赖包版本过旧
  旧版本的passport-google-oauth20可能存在refreshToken返回的bug，执行命令更新到最新版本：

  npm update passport-google-oauth20
  

• Google Cloud控制台配置问题
  检查你的OAuth客户端配置：

  • 确保客户端类型为「Web应用」
  • 回调URL和代码里的callbackURL完全一致（包括协议、端口、路径）

内容的提问来源于stack exchange，提问作者Everton Trindade