本教程旨在解决使用Go语言通过Google Drive API上传大文件时遇到的问题。文章将首先阐述 `google-api-go-client` 库中标准文件上传方法的行为，特别是其对大文件的自动处理机制（可恢复上传）。随后，将探讨当标准方法遇到问题时，如何构建和发送一个通用的 `net/http` multipart请求作为替代方案，并强调其适用场景及注意事项。
1. Google Drive API Go客户端与文件上传概述
在使用Go语言与Google Drive API交互时，google-api-go-client 是官方推荐的客户端库。它封装了底层的HTTP请求，简化了文件管理等操作。对于文件上传，最常用的方法是 Files.Insert().Media()。
标准上传示例：
import (
"log"
"os"
"path/filepath"
"google.golang.org/api/drive/v3" // 或 v2，取决于你的API版本
// ... 其他导入，如 context, oauth2 等
)
// 假设 service 已经通过 OAuth2 认证并初始化
func uploadSmallFile(service *drive.Service, filePath string) (*drive.File, error) {
goFile, err := os.Open(filePath)
if err != nil {
return nil, fmt.Errorf("error opening file: %v", err)
}
defer goFile.Close()
fileMetadata := &drive.File{
Name: filepath.Base(filePath), // 使用 Name 字段，v3 API
// Title: filepath.Base(filePath), // 如果是 v2 API，则使用 Title 字段
}
// Media 方法会自动处理文件内容
uploadedFile, err := service.Files.Create(fileMetadata).Media(goFile).Do() // v3 API
// _, err = service.Files.Insert(fileMetadata).Media(goFile).Ocr(true).Do() // v2 API 示例
if err != nil {
return nil, fmt.Errorf("error uploading file: %v", err)
}
return uploadedFile, nil
}对于大多数小文件，上述代码能够正常工作。然而，当文件大小超过一定阈值（例如5MB）时，用户可能会遇到上传失败，如 500 Internal Server Error。这可能让人误以为标准方法不支持大文件上传，或者需要手动实现 multipart 上传。
立即学习“go语言免费学习笔记（深入）”；
2. Google Drive API 大文件上传机制：可恢复上传
实际上，google-api-go-client 库的 Media() 方法设计之初就考虑了大文件的上传。当通过 Media() 方法提供的 io.Reader 源文件较大时，客户端库会自动启用 Google Drive 的可恢复上传（Resumable Upload）协议。
可恢复上传协议的优势在于：
- 断点续传： 即使上传过程中网络中断或服务器错误，也可以从上次中断的地方继续上传，无需重新开始。
- 稳定性： 针对大文件传输进行了优化，减少了因网络波动导致上传失败的概率。
因此，对于大多数情况，你无需手动实现 multipart 上传来处理大文件。如果在使用 Media() 方法上传大文件时仍然遇到 500 错误，原因可能不是因为缺少 multipart 机制，而可能是以下因素：
- 网络瞬时错误： 服务器端或客户端的网络问题。
- 认证/授权问题： 访问令牌过期或权限不足。
- API 配额限制： 达到了Google Drive API的上传配额。
- 服务器端错误： Google Drive服务端的临时问题。
- 文件内容问题： 文件本身可能损坏或包含特殊字符导致解析失败。
在这种情况下，建议检查错误日志，并考虑实现重试机制（特别是针对网络瞬时错误）。
3. 手动构建 Multipart 请求（通用 net/http 方法）
尽管 google-api-go-client 推荐使用其内置的可恢复上传机制，但在某些特定场景下，例如调试、与非标准API集成，或者深入理解HTTP协议细节时，手动构建 multipart/form-data 请求可能会有用。
以下代码示例展示了如何使用Go标准库 net/http 和 mime/multipart 来构建一个通用的 multipart/form-data 请求。请注意，Google Drive API 通常使用 multipart/related 类型进行文件上传，其中包含一个JSON部分的元数据和一个文件内容部分。本示例主要演示 multipart/form-data 的通用构建方式，与Google Drive API的特定 multipart 格式略有不同，但核心原理相通。
package main
import (
"bytes"
"fmt"
"io"
"mime/multipart"
"net/http"
"os"
"path/filepath"
"log"
)
// uploadFileManually 演示如何使用 Go 的标准库构建并发送一个通用的 multipart/form-data 请求。
// fieldName 是指在 multipart 表单中，文件内容对应的字段名。
// 注意：对于 Google Drive API，推荐使用 google-api-go-client 的 Media() 方法，
// 它会自动处理大文件的可恢复上传。此示例主要用于理解底层 HTTP 机制。
func uploadFileManually(filePath, fieldName, targetURI string) error {
file, err := os.Open(filePath)
if err != nil {
return fmt.Errorf("error opening file: %w", err)
}
defer file.Close()
body := &bytes.Buffer{}
writer := multipart.NewWriter(body)
// 创建一个表单文件部分，用于承载实际的文件内容
// fieldName 是表单字段名，filepath.Base(filePath) 是文件名
part, err := writer.CreateFormFile(fieldName, filepath.Base(filePath))
if err != nil {
return fmt.Errorf("error creating form file: %w", err)
}
// 将文件内容拷贝到 multipart 
