使用NodeJS下载Google Drive共享文件时遭遇访问权限错误求助

我之前碰到过一模一样的问题，这个错误的核心原因是：你的应用身份（不管是用服务账号还是OAuth2用户授权）并没有获得目标文件的实际内容读取权限——哪怕你能成功获取文件元数据，下载文件内容需要更明确的权限验证。下面是几个针对性的解决方案，完全不需要用文件选择器，能满足你自动下载的需求：

1. 服务账号授权场景：添加服务账号到共享文件夹 #

如果你的应用用的是服务账号（最适合后台自动任务），服务账号是一个独立的Google身份，哪怕文件是公开共享的，它默认也没有访问权限。解决步骤：

• 找到你的服务账号邮箱（在Google Cloud控制台的IAM -> 服务账号里查看）
• 打开目标共享Google Drive文件夹，点击「共享」，把服务账号邮箱添加进去，授予「查看者」权限
• 重新运行你的下载代码，此时服务账号就能正常读取文件内容了

对应的下载代码示例（确保调用时加alt: 'media'）：

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

// 初始化服务账号客户端
const auth = new google.auth.GoogleAuth({
  keyFile: 'service-account-key.json',
  scopes: ['https://www.googleapis.com/auth/drive.readonly'],
});

const drive = google.drive({ version: 'v3', auth });

async function downloadFile(fileId, savePath) {
  const res = await drive.files.get(
    {
      fileId: fileId,
      alt: 'media', // 关键参数：请求文件内容而非元数据
      supportsAllDrives: true, // 如果共享文件夹属于团队盘，必须加这个
    },
    { responseType: 'stream' }
  );

  // 写入本地文件
  return new Promise((resolve, reject) => {
    const writeStream = require('fs').createWriteStream(savePath);
    res.data.pipe(writeStream);
    writeStream.on('finish', resolve);
    writeStream.on('error', reject);
  });
}

2. OAuth2用户授权场景：确保权限范围和参数正确 #

如果你的应用用的是OAuth2用户授权（代表某个用户操作）：

• 确认授权时请求的权限范围包含https://www.googleapis.com/auth/drive.readonly（或更高级的drive权限），用户必须同意这个权限
• 调用files.get下载时，务必加上supportsAllDrives: true参数（尤其是共享文件夹属于团队盘的情况）
• 对于完全公开的文件，也可以尝试直接使用文件的webContentLink来下载（不需要通过Drive API），但要注意如果文件权限变更，这个链接可能失效

3. 额外排查点 #

• 检查文件的共享权限：确保文件是「知道链接的任何人可查看」，而不是「仅限特定用户」
• 如果是团队盘里的文件，除了supportsAllDrives: true，还要确保你的应用授权时包含了团队盘的访问权限

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