调用Google Drive API的drive.changes.list返回空changes数组求助

可能的原因 #

• 起始页令牌使用逻辑错误：drive.changes.getStartPageToken返回的是调用时刻的起始令牌，仅能追踪该时刻之后发生的变更。你在文件修改后才获取新令牌，自然无法拿到之前的修改记录；且每次Webhook触发后都重新获取起始令牌，会丢失之前的变更追踪上下文。
• 未持久化复用页令牌：Drive Changes API要求复用上次请求返回的newStartPageToken来获取后续变更。如果每次都重新调用getStartPageToken，相当于每次都重置追踪起点，无法累积获取历史变更。
• 权限范围不足：若OAuth2授权的scope仅为drive.metadata.readonly这类受限范围，可能无法获取完整的变更资源，导致返回空数组。
• 变更同步延迟：极少数情况下Drive后台变更同步存在延迟，不过该情况概率极低。

对应的解决方法 #

1. 持久化并复用页令牌 #

这是核心解决步骤，需要维护一个持久化存储（如数据库、本地配置文件）来保存页令牌：

// 从持久化存储中读取上次保存的pageToken，首次启动时为null
let savedPageToken = await getSavedPageToken(); 

const drive = google.drive("v3");
console.log("Authentication successful");

// 首次启动时初始化起始令牌
if (!savedPageToken) {
    const start = await drive.changes.getStartPageToken({ auth: oauth2Client });
    savedPageToken = start.data.startPageToken;
    await savePageToken(savedPageToken); // 将令牌存入持久化存储
}

// 使用保存的令牌拉取变更
const changes = await drive.changes.list({
    auth: oauth2Client,
    pageToken: savedPageToken,
    includeItemsFromAllDrives: true, // 涉及共享驱动器时需开启
    supportsAllDrives: true
});

console.log("changes are ", changes.data);
// 更新存储的令牌为最新的newStartPageToken，用于下一次请求
await savePageToken(changes.data.newStartPageToken);
return changes.data.changes;

2. 检查并调整权限范围 #

确保OAuth2授权请求的scope包含https://www.googleapis.com/auth/drive.readonly（或更高权限，遵循最小必要权限原则），避免因权限不足无法获取变更资源。

3. 验证Webhook触发时机 #

确认Webhook是在文件修改完成后触发的，可通过日志对比Webhook触发时间与文件修改时间，排除因触发时机错误导致的变更遗漏。

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