使用Google Drive API调用时出现403权限不足错误求助

核心问题排查与修复步骤 #

1. 确认Google Drive API已启用 #

• 登录Google Cloud控制台，找到对应项目，在API库中搜索Google Drive API，确保该API处于启用状态。未启用的API会直接返回403错误。

2. 检查API密钥的访问限制 #

• API密钥若设置了过严的访问限制（比如仅允许特定域名/IP），而你的Next.js开发环境（如localhost:3000）不在允许列表内，会触发403。
• 进入API密钥编辑页面，可暂时移除HTTP referrers等限制进行测试，确认是否为限制导致的问题。生产环境需重新配置严格限制，避免密钥泄露风险。

3. API密钥仅支持公开文件访问，私有文件需换用OAuth2或服务账号 #

• 你当前使用API密钥认证，但files.list接口访问非公开的个人Drive文件时，API密钥权限不足，必须使用OAuth2用户授权或服务账号认证：
  • 若访问自己的私有文件，推荐用服务账号：
    1. 在Google Cloud控制台创建服务账号，下载JSON密钥文件。
    2. 将密钥文件放在项目安全目录（勿提交至Git），代码中加载认证：

       import { GoogleAuth } from 'google-auth-library';
       import { google } from 'googleapis';
       
       const auth = new GoogleAuth({
         keyFile: './service-account-key.json', // 你的密钥文件路径
         scopes: ['https://www.googleapis.com/auth/drive.readonly'],
       });
       
       const drive = google.drive({ version: 'v3', auth });
       

    3. 将服务账号邮箱添加到目标文件/文件夹的共享列表，赋予查看权限。

4. 清理代码冗余并优化请求参数 #

• 你代码中定义的fileId未实际使用，files.list用于批量列文件，无需传入单个文件ID。可添加参数控制返回结果：

  const exportedDoc = await drive.files.list({
    pageSize: 10, // 控制单次返回的文件数量
    fields: 'nextPageToken, files(id, name)', // 指定返回字段，减少数据量
  });
  

5. 验证文件共享权限 #

• 若访问他人共享的文件，需确保文件已设置为**“知道链接的任何人都能查看”**，否则即使认证正确也会返回403。

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