如何在Flutter应用中通过服务账号后台上传用户文件至个人Google Drive？

完全可以用服务账号实现后台无感知上传到你的个人Drive指定文件夹，核心是完成服务账号的授权配置，再正确生成短期令牌。以下是具体解决步骤：

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

• 登录Google Cloud控制台，创建服务账号并下载JSON密钥文件，把文件放到Flutter项目的assets目录（记得在pubspec.yaml里声明该资源）
• 打开你的个人Google Drive，找到目标上传文件夹，右键选「共享」，将服务账号JSON密钥里的client_email邮箱添加为编辑权限，确保服务账号能访问这个文件夹

2. 修复JWT令牌错误（invalid_grant） #

你碰到的错误是因为JWT的签发时间(iat)或过期时间(exp)不符合要求，或者设备时间与服务器时间偏差太大。解决方法：

• 开启设备自动时间校准，确保本地时间和网络时间同步
• 不要手动构造JWT，用官方库生成令牌，避免时间参数出错。推荐用googleapis_auth和googleapis包

3. 完整上传代码示例 #

先在pubspec.yaml添加依赖：

dependencies:
  flutter:
    sdk: flutter
  googleapis: ^12.0.0
  googleapis_auth: ^1.4.1
  http: ^1.1.0
  path_provider: ^2.1.1

然后编写上传逻辑：

import 'dart:io';
import 'package:googleapis/drive/v3.dart' as drive;
import 'package:googleapis_auth/auth_io.dart';
import 'package:flutter/services.dart';
import 'package:image_picker/image_picker.dart';

// 上传Xfile到指定Drive文件夹
Future<void> uploadToMyDrive(XFile file, String targetFolderId) async {
  // 加载服务账号密钥文件
  final String serviceAccountJson = await rootBundle.loadString('assets/service_account.json');
  final credentials = ServiceAccountCredentials.fromJson(serviceAccountJson);

  // 申请Drive API的必要权限范围
  final scopes = [drive.DriveApi.driveFileScope];

  // 获取授权客户端
  final client = await clientViaServiceAccount(credentials, scopes);
  try {
    final driveApi = drive.DriveApi(client);

    // 设置文件元数据，指定父文件夹ID
    final fileMetadata = drive.File()
      ..name = file.name
      ..parents = [targetFolderId];

    // 读取本地文件流
    final fileStream = File(file.path).openRead();
    final media = drive.Media(fileStream, File(file.path).lengthSync());

    // 执行上传
    await driveApi.files.create(
      fileMetadata,
      uploadMedia: media,
    );
  } finally {
    client.close();
  }
}

4. 关键注意事项 #

• 服务账号密钥文件别提交到版本控制，把它加入.gitignore
• 给服务账号最小权限，只授予目标文件夹的编辑权，不要给全局Drive权限
• 令牌由googleapis_auth自动管理，默认有效期60分钟，会自动刷新，不用手动处理时间参数

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