如何诊断Google Drive文件创建成功但无数据上传的故障？

1. 本地文件合法性校验 #

• 检查pathLocalFile指向的本地文件状态：部分设备因Android 10+分区存储限制、权限缺失（如未申请MANAGE_EXTERNAL_STORAGE），会导致文件实际无法读取但不抛出异常。上传前必须添加校验：

  if (!fileData.exists() || !fileData.canRead() || fileData.length() == 0) {
      // 记录日志，确认文件是否存在、可读、非空
  }
  

• 重点排查问题设备的存储权限：比如应用是否通过SAF（存储访问框架）获取了文件访问权，而非直接依赖旧的READ_EXTERNAL_STORAGE权限。

2. MIME类型合理性检查 #

• 当前使用的"file/binary"是非标准MIME类型，部分设备的Drive API服务端或客户端可能无法正确解析，导致文件数据被忽略。建议替换为对应文件的标准MIME类型（如图片用"image/jpeg"，文档用"application/pdf"），或自动探测：

  String mimeType = Files.probeContentType(fileData.toPath());
  FileContent fileContent = new FileContent(mimeType, fileData);
  

3. API请求完整性验证 #

• 开启API调试日志：通过HttpLoggingInterceptor打印完整的请求/响应内容，确认请求体是否包含文件数据、服务端是否返回隐藏警告：

  HttpLoggingInterceptor logging = new HttpLoggingInterceptor();
  logging.setLevel(HttpLoggingInterceptor.Level.BODY);
  OkHttpClient client = new OkHttpClient.Builder().addInterceptor(logging).build();
  googleDriveService.setHttpRequestInitializer(client);
  

• 改用分块上传并监听进度：大文件上传时，部分设备网络不稳定可能导致请求提前结束但无异常，分块上传可明确监控传输进度：

  MediaHttpUploader uploader = googleDriveService.files().create(fileMetadata, fileContent).getMediaHttpUploader();
  uploader.setChunkSize(MediaHttpUploader.MINIMUM_CHUNK_SIZE);
  uploader.setProgressListener(uploader -> {
      // 记录上传进度，确认是否达到100%完成状态
  });
  com.google.api.services.drive.model.File file = uploader.getRequest().setFields("*").execute();
  

4. 设备特定环境排查 #

• 网络环境差异：问题设备可能处于代理网络、企业内网，导致文件数据传输被拦截但元数据请求成功。测试不同网络（WiFi/移动数据）下的上传效果，检查设备代理设置。
• Google Play服务版本：Drive API依赖Play服务，版本过低或异常会导致上传逻辑执行不完整。检查问题设备的Play服务版本，建议更新至最新版，或在应用中添加版本校验逻辑。
• 定制ROM兼容性：部分国产定制ROM对存储、网络的特殊限制，可能导致文件读取或传输静默失败，针对问题设备的ROM品牌、Android版本做针对性测试。

5. 异常捕获与事后校验 #

• 扩大异常捕获范围：当前代码未显式捕获异常，可能存在未被捕获的IOException子类或运行时异常，添加完整日志记录：

  try {
      com.google.api.services.drive.model.File file = googleDriveService.files().create(fileMetadata, fileContent)
          .setFields("*")
          .execute();
      // 记录上传后Drive文件的ID、大小等信息
  } catch (Exception e) {
      // 记录完整异常栈、设备型号、Android版本、本地文件路径
  }
  

• 上传后校验文件完整性：调用Drive API获取上传文件的实际大小，与本地文件对比，不一致则标记为上传失败：

  com.google.api.services.drive.model.File uploadedFile = googleDriveService.files().get(file.getId())
      .setFields("size")
      .execute();
  if (uploadedFile.getSize() != fileData.length()) {
      // 记录文件大小不匹配的异常日志
  }
  

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