Laravel使用google/apiclient传文件至Google Drive遇401认证问题

完全可以实现以服务器身份完成API调用，不需要向用户展示登录弹窗。你遇到的401错误是因为当前使用的是OAuth客户端密钥，这种方式需要用户授权获取令牌；而**Google服务账号（Service Account）**正是为服务器端无用户交互的场景设计的，下面是具体实现步骤：

1. 准备服务账号与权限配置 #

• 登录Google Cloud控制台，进入你的项目，依次进入「IAM与 Admin」→「服务账号」→「创建服务账号」，完成后进入该服务账号的详情页
• 点击「密钥」→「添加密钥」→「创建新密钥」，选择JSON格式，下载密钥文件到本地
• 将密钥文件放到Laravel项目的storage/app目录下（记得在.gitignore中排除该文件，避免密钥泄露）
• 打开Google Drive，找到你要上传文件的目标文件夹，右键选择「共享」，输入密钥文件中client_email字段对应的邮箱地址，设置权限为「编辑者」并保存

2. 配置Laravel环境变量 #

在.env中添加以下配置：

GOOGLE_APP_NAME=你的应用名称
GOOGLE_SERVICE_ACCOUNT_KEY=storage/app/你的服务账号密钥文件名.json
GOOGLE_DRIVE_SCOPE=https://www.googleapis.com/auth/drive.file

（drive.file权限仅允许服务账号访问自己上传的文件，若需要全Drive权限可替换为https://www.googleapis.com/auth/drive）

3. 修改上传方法的认证逻辑 #

替换原有postFile方法中的Google客户端初始化代码，改用服务账号认证：

private function postFile($filepath, $file) {
    try {
        $client = new GoogleClient();
        $client->setApplicationName(config('google.application_name'));
        // 加载服务账号密钥文件
        $client->setAuthConfig(base_path(config('google.service_account_key')));
        $client->setScopes([config('google.scopes')]);
        // 服务账号自动获取访问令牌（库会自动处理令牌缓存与刷新）
        $client->fetchAccessTokenWithAssertion();

        $drive = new Drive($client);
        $fileMetaData = new DriveFile([
            'name' => $file->getClientOriginalName(),
            // 可选：指定上传到Drive的目标文件夹，替换为实际的文件夹ID（从Drive URL提取）
            'parents' => ['你的Drive文件夹ID']
        ]);

        $content = file_get_contents($file->getRealPath());

        $driveFile = $drive->files->create($fileMetaData, [
            'data' => $content,
            'mimeType' => $file->getMimeType(),
            'uploadType' => 'multipart',
            'fields' => 'id,name'
        ]);

        dd($driveFile);

    } catch(\Exception $e) {
       dd($e->getMessage());
    }
}

关键说明 #

• 不需要编写额外中间件，服务账号的认证逻辑直接在postFile方法中完成即可，Google Client库会自动缓存访问令牌，过期后自动刷新
• 服务账号拥有独立的Drive存储空间，若要上传到你个人Drive的文件夹，必须完成「共享文件夹给服务账号邮箱」的步骤，否则服务账号无法访问该文件夹

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