使用googleapis Node.js客户端时，如何检测并处理Calendar权限被移除问题？

我之前也碰到过一模一样的坑！用googleapis对接Calendar时，用户手动在谷歌账号安全设置里撤销权限后，客户端居然还显示「已连接」，完全没感知到权限失效。后来查了官方文档加上自己踩坑试出来几个靠谱的方法，分享给你：

一、如何检测权限是否被移除 #

核心思路是：通过轻量API请求或者Token校验，判断当前凭证是否还拥有有效权限，以下是两种实用的Node.js实现方式：

方法1：用Calendar轻量API请求验证 #

直接调用一个权限要求最低的Calendar接口（比如获取日历列表的最小请求），如果权限被撤销，会返回明确的401/403错误：

const { google } = require('googleapis');

async function isCalendarPermissionValid(auth) {
  try {
    const calendar = google.calendar({ version: 'v3', auth });
    // 只请求1条日历数据，尽量减少资源消耗
    await calendar.calendarList.list({ maxResults: 1 });
    return true; // 权限有效
  } catch (err) {
    // 重点拦截401（未授权/Token失效）、403（权限被撤销）
    if (err.code === 401 || err.code === 403) {
      return false;
    }
    // 其他错误（如网络问题）抛出，单独处理
    throw err;
  }
}

方法2：用OAuth2 Token Info校验 #

利用谷歌的Token校验端点，验证当前access token的有效性和权限范围：

const { google } = require('googleapis');

async function isTokenValid(auth) {
  const oauth2Client = google.oauth2({ version: 'v2', auth });
  try {
    const tokenInfo = await oauth2Client.tokeninfo({
      access_token: auth.credentials.access_token
    });
    // 额外校验是否包含你需要的Calendar权限（比如读写权限）
    const requiredScope = 'https://www.googleapis.com/auth/calendar';
    if (tokenInfo.data.scope.includes(requiredScope)) {
      return true;
    }
    return false;
  } catch (err) {
    // Token无效、权限被撤都会触发错误
    return false;
  }
}

二、权限失效后的处理最佳实践 #

• 实时错误拦截：在所有Calendar API调用的catch块里统一检测401/403错误，一旦触发立即标记权限失效，不要再继续使用旧凭证
• 定期主动检测：不要只在初始化时检查，建议每次调用API前或者定时（比如每天一次）做一次权限校验，避免长期处于“假连接”状态
• 清理本地凭证：检测到权限失效后，立即删除本地存储的refresh token和access token，防止后续请求重复使用无效凭证
• 用户友好引导：给用户明确的提示（比如「你的Google Calendar权限已被撤销，请重新连接」），并提供一键重新授权的入口，引导用户完成授权流程

关键注意点 #

• 如果你的应用使用了refresh token，当用户撤销权限后，用这个refresh token去刷新access token会直接返回401错误，这时候一定要彻底清空旧的refresh token，不能再尝试复用
• 不要依赖客户端本地的状态判断连接状态，必须以谷歌API的返回结果为准

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