使用gapi导出Google Workspace文件为Office格式时文件损坏问题

问题根因 #

导出的Office文件损坏是因为gapi客户端默认将二进制响应按UTF-8文本解析，直接转base64会导致字节丢失或篡改，最终生成的文件结构损坏。PDF格式容错性更强，少量字节错误不影响基础打开，所以看起来正常。
Google Workspace原生文件（Docs/Sheets/Slides等）本身没有md5Checksum属性，只有上传到Drive的第三方二进制文件才会返回该字段，无法获取属于正常情况。

解决方案 #

方案1：修正gapi请求及二进制转换逻辑 #

调用files.export时显式指定alt: 'media'要求返回二进制流，再将响应内容正确转换为Blob：

gapi.client.drive.files.export({
  fileId: fileId,
  mimeType: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
  alt: 'media'
}).then(response => {
  // 将文本格式的二进制响应转成Uint8Array
  const uint8Array = new Uint8Array(response.body.length);
  for (let i = 0; i < response.body.length; i++) {
    uint8Array[i] = response.body.charCodeAt(i) & 0xff;
  }
  // 生成对应格式的Blob
  const blob = new Blob([uint8Array], {
    type: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document'
  });
  // 下载逻辑
  const downloadUrl = URL.createObjectURL(blob);
  const a = document.createElement('a');
  a.href = downloadUrl;
  a.download = '导出文件.docx';
  document.body.appendChild(a);
  a.click();
  document.body.removeChild(a);
  URL.revokeObjectURL(downloadUrl);
})

导出Excel格式时只需要替换请求和Blob对应的mimeType为application/vnd.openxmlformats-officedocument.spreadsheetml.sheet即可。

方案2：直接用fetch调用API（更稳定） #

避免gapi的默认文本解析逻辑，直接拿到正确的Blob对象：

const accessToken = gapi.auth.getToken().access_token;
const exportMimeType = 'application/vnd.openxmlformats-officedocument.wordprocessingml.document';
fetch(`https://www.googleapis.com/drive/v3/files/${fileId}/export?mimeType=${encodeURIComponent(exportMimeType)}`, {
  headers: {
    'Authorization': `Bearer ${accessToken}`
  }
}).then(res => res.blob())
.then(blob => {
  // 复用上面的下载逻辑即可
})

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