UploadThing 项目中如何上传 Excel 和 Word 文档

在开发基于 UploadThing 的文件上传功能时，许多开发者会遇到一个常见需求：如何支持 Microsoft Office 文档（如 .docx 和 .xlsx 文件）的上传。本文将详细介绍在 UploadThing 项目中实现这一功能的技术方案。

MIME 类型的重要性

文件上传功能的核心在于正确识别文件类型。现代 Web 应用通过 MIME 类型（媒体类型）来识别不同格式的文件。对于 Office 文档，它们有特定的 MIME 类型标识：

• .docx 文件：application/vnd.openxmlformats-officedocument.wordprocessingml.document
• .xlsx 文件：application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

在 UploadThing 中配置 Office 文档支持

UploadThing 的文件路由配置允许开发者通过指定 MIME 类型来限制可上传的文件格式。以下是配置示例：

const f = createFileRouter();

f.route({
  officeFiles: {
    maxFileSize: "4MB",
    maxFileCount: 10,
    accept: {
      "application/vnd.openxmlformats-officedocument.wordprocessingml.document": [".docx"],
      "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": [".xlsx"]
    }
  }
});

实际应用中的注意事项

1. 文件大小限制：Office 文档可能包含大量内容，建议适当增加 maxFileSize 限制
2. 安全性考虑：虽然配置了 MIME 类型，但仍应在服务器端验证实际文件类型
3. 用户体验：在前端界面中明确提示支持的文档格式
4. 错误处理：为不支持的格式提供友好的错误提示

为什么这些 MIME 类型不是默认包含

虽然 Office 文档在商业应用中很常见，但 UploadThing 作为通用文件上传解决方案，默认只包含最基础的 MIME 类型。这种设计有以下考虑：

1. 保持核心功能的轻量化
2. 避免不必要的类型冲突
3. 让开发者根据实际需求灵活配置
4. 减少潜在的安全风险

扩展支持其他 Office 文档

同样的方法可以扩展支持其他 Office 文件格式：

• PowerPoint (.pptx): application/vnd.openxmlformats-officedocument.presentationml.presentation
• 传统 Word 文档 (.doc): application/msword
• 传统 Excel 文档 (.xls): application/vnd.ms-excel

通过理解 MIME 类型机制并正确配置 UploadThing，开发者可以轻松实现各种 Office 文档的上传功能，满足企业级应用的需求。