如何在Google OAuth NodeJS库中用refresh token静默获取新access token

可行解决方案 #

你要的强制静默刷新能力谷歌官方的OAuth NodeJS库实际已经提供了，不需要额外封装，以下是两种落地方式：

1. 主动强制刷新（完全符合你要的调用效果）

你只需要提前存储好用户首次授权时返回的refresh_token，直接调用库内置的refreshToken方法即可随时触发刷新，不需要等待tokens事件回调：

// 从你的持久化存储（数据库/缓存）中取出对应用户的历史refresh_token
const storedRefreshToken = getUserRefreshTokenFromDB(loginUserId);
const oauth2Client = initOAuth2Client();

// 主动调用刷新接口，静默获取新凭证
const { credentials } = await oauth2Client.refreshToken(storedRefreshToken);
// 新凭证包含新的access_token、过期时间等
const newAccessToken = credentials.access_token;
const newExpiryTime = credentials.expiry_date;

// 更新存储的凭证，同时设置到client即可正常使用
oauth2Client.setCredentials({
  refresh_token: storedRefreshToken,
  access_token: newAccessToken,
  expiry_date: newExpiryTime
});

2. 自动刷新（无需手动判断时机，库自动处理）

你遇到的Refresh Token is not set报错，90%以上的场景是你调用setCredentials的时候，只传入了access_token没有传入提前存储的refresh_token导致的。只要初始化时传入完整凭证，库会自动在access token过期前静默刷新，不需要你手动写逻辑：

const oauth2Client = initOAuth2Client();
// 传入完整凭证，必须包含refresh_token
oauth2Client.setCredentials({
  access_token: currentValidAccessToken,
  refresh_token: storedRefreshToken, // 必须传，库会用这个值自动刷新
  expiry_date: currentTokenExpiryTime
});

// 后续直接调用谷歌接口即可，刷新过程完全透明，刷新后会触发tokens事件更新凭证
oauth2Client.on('tokens', (newTokens) => {
  // 这里更新你的存储里的access_token和过期时间即可，refresh_token一般不会变不用更新
  updateUserTokenInDB(loginUserId, newTokens.access_token, newTokens.expiry_date);
});

注意事项 #

首次生成用户授权链接时，必须携带access_type=offline参数，如果用户已经授权过，还要额外加prompt=consent参数，才能拿到refresh_token，否则后续无法完成刷新操作。

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