如何通过Google Drive API下载文件？403权限不足问题求助

一、先搞定403权限错误 #

1. 权限设置后有延迟，别着急拿链接 #

你现在的代码在调用setPermissionPublic后立刻请求webContentLink，但Google Drive的权限变更不是即时生效的，通常要等几秒。直接请求大概率会因为权限还没同步触发403。给代码加个短暂等待或者重试逻辑：

修改downloadFileDriveServer：

public function downloadFileDriveServer(string $fileId) {
    try {
        $this->setPermissionPublic($fileId);
        // 等2秒让权限生效，时长可根据实际情况调整
        sleep(2);
        
        // 最多重试3次，避免偶发延迟问题
        $retryCount = 0;
        do {
            $file = $this->service->files->get(
                $fileId, 
                ['fields' => 'webContentLink']
            );
            if ($downloadLink = $file->getWebContentLink()) {
                return $downloadLink;
            }
            sleep(1);
            $retryCount++;
        } while ($retryCount < 3);
        
        throw new Exception("重试3次后仍无法获取下载链接");
    } catch (\Google\Service\Exception $e) {
        error_log("Google API错误: " . $e->getMessage());
        throw $e;
    }
}

2. 先确认权限真的设置成功了 #

你的setPermissionPublic没加异常捕获，说不定权限创建本身就失败了（比如文件在共享驱动器里，服务账号没权限改权限）。给这个函数加上异常处理，确保权限设置没问题：

private function setPermissionPublic(string $fileId) {
    try {
        $permission = new \Google\Service\Drive\Permission();
        $permission->setRole('reader');
        $permission->setType('anyone');
        // 加sendNotificationEmail=false，避免给所有人发通知邮件
        $this->service->permissions->create($fileId, $permission, ['sendNotificationEmail' => false]);
    } catch (\Google\Service\Exception $e) {
        error_log("设置公开权限失败: " . $e->getMessage());
        throw $e;
    }
}

3. 检查文件的归属和基础权限 #

• 如果文件在**共享驱动器（Team Drive）**里，得确保服务账号被加进了驱动器，且拥有「组织者」或「内容管理者」角色——只有这两个角色能改文件权限。
• 如果是用户共享给服务账号的文件，必须给服务账号编辑权限，不然服务账号没资格改文件的权限设置。

二、用alt=media直接下载文件的方法 #

GET https://www.googleapis.com/drive/v3/files/fileId?alt=media是Drive API提供的直接拉取文件内容的接口，不用依赖webContentLink，适合内部使用场景。给你两种实现方式：

方式1：通过Google Drive Service调用 #

直接用已初始化的$service请求，最省心：

public function downloadFileContent(string $fileId) {
    try {
        // 先确保有权限（如果需要公开访问的话）
        $this->setPermissionPublic($fileId);
        sleep(2);
        
        // 加alt=media参数，告诉API返回文件二进制内容
        $response = $this->service->files->get($fileId, ['alt' => 'media']);
        
        // 获取文件内容并输出下载响应
        $content = $response->getBody()->getContents();
        
        header('Content-Type: ' . $response->getHeaderLine('Content-Type'));
        header('Content-Disposition: attachment; filename="downloaded-file"');
        echo $content;
        exit;
    } catch (\Google\Service\Exception $e) {
        error_log("下载错误: " . $e->getMessage());
        throw $e;
    }
}

方式2：手动用CURL请求 #

如果想自己控制HTTP请求，可以用服务账号的访问令牌构造请求：

public function downloadFileViaCurl(string $fileId) {
    // 从已授权的Client里拿访问令牌
    $token = $this->service->getClient()->getAccessToken()['access_token'];
    $url = "https://www.googleapis.com/drive/v3/files/{$fileId}?alt=media";
    
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        "Authorization: Bearer {$token}"
    ]);
    
    $content = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    
    if ($httpCode !== 200) {
        throw new Exception("下载失败，状态码: {$httpCode}，错误信息: {$content}");
    }
    
    curl_close($ch);
    
    // 输出下载响应
    header('Content-Type: application/octet-stream');
    header('Content-Disposition: attachment; filename="file"');
    echo $content;
    exit;
}

三、额外排查点 #

• 确认服务账号的密钥文件正确，代码里加载的是正确的密钥。
• 去Google Cloud控制台检查，服务账号是否启用了Drive API的访问权限。
• 查看API配额是否超限——可以在Google Cloud的API用量页面查看，配额超了也会出现异常权限错误。

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