使用 google drive api 上传 `.docx` 文件并自动转换为 google docs 时，必须同时设置元数据中的 `mimetype` 为 `application/vnd.google-apps.document`，且 **不能** 将原始文件内容的 mime 类型设为该值——否则会因内容类型不匹配触发 400 错误。
在 Google Drive API 中，application/vnd.google-apps.document 是一个虚拟 MIME 类型，仅用于标识目标资源类型（即“创建一个 Google Docs 文档”），它不能作为实际上传文件流的媒体类型。当你调用 new FileContent(type, filePath) 并传入 application/vnd.google-apps.document 时，API 会尝试将 .docx 二进制内容按 Google Docs 格式解析，从而报错：Invalid MIME type provided for the uploaded content.
✅ 正确做法是：
- 文件内容（FileContent）使用其原始真实 MIME 类型（如 .docx 对应 application/vnd.openxmlformats-officedocument.wordprocessingml.document）；
- 元数据对象（File）中显式设置 mimeType 为目标 Google 文档类型，以触发自动转换。
以下是修复后的完整 Java 示例代码：
Drive service = getDriveService();
// 1. 构建文件元数据，并指定目标类型为 Google Docs
com.google.api.services.drive.model.File fileMetadata = new com.google.api.services.drive.model.File();
fileMetadata.setName("sample");
fileMetadata.setMimeType("application/vnd.google-apps.document"); // ✅ 关键：仅在此处设置
// 2. 使用原始 DOCX 的真实 MIME 类型构造 FileContent
java.io.File filePath = new java.io.File("C:\Users\sample.docx");
String docxMimeType = "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
FileContent mediaContent = new FileContent(docxMimeType, filePath);
// 3. 执行创建（自动转换）
com.google.api.services.drive.model.File file = service.files()
.create(fileMetadata, mediaContent)
.setFields("id, name, mimeType, webViewLink")
.execute();
System.out.println("Google Doc ID: " + file.getId());
System.out.println("View URL: " + file.getWebViewLink());⚠️ 注意事项：
- 必须确保服务账号或 OAuth 用户拥有对目标 Drive 文件夹的写入权限；
- .docx 文件需符合 Office Open XML 规范，损坏或加密文件可能导致转换失败（无明确错误，但生成空文档）；
- 不支持直接上传 .pdf 或图片并设为 application/vnd.google-apps.document —— PDF 需用 application/vnd.google-apps.spreadsheet（表格）等对应类型，或先转为 DOCX；
- 若需保留原始 .docx 副本，可额外调用一次 files().create() 上传原始文件（使用其真实 MIME 类型，不设 mimeType 字段）。
总结：Google Drive 的“上传并转换”机制依赖元数据 mimeType + 原始内容真实 MIME 类型的组合。混淆二者是此类 400 错误的根本原因。遵循“内容用真类型、目标用虚拟类型”的原则，即可稳定实现 DOCX → Google Docs 自动转换。
