Mozilla Send 文件上传失败问题分析与解决方案

问题现象

近期有用户报告其长期稳定运行的 Mozilla Send 服务突然出现大文件上传失败的问题。具体表现为：

• 上传 1.4GB 左右的文件时，进度在 40-70% 之间失败
• 上传失败后云服务器的内存几乎被占满
• 需要重启 Docker 堆栈才能恢复服务
• 小文件上传不受影响

问题分析

经过技术排查，发现问题的根本原因在于文件上传过程中，系统将上传的文件内容暂时存储在内存而非指定的文件目录中。这导致：

1. 内存耗尽：当上传文件大小接近或超过服务器可用内存时，系统因内存不足而中断上传
2. 服务不可用：内存饱和导致整个 Send 服务需要重启才能恢复

值得注意的是，该问题在长期稳定运行后突然出现，而用户确认期间未对系统配置进行任何修改。

解决方案

针对此问题，我们推荐以下解决方案：

1. 明确指定文件存储目录：

   • 在 Docker 环境变量中设置 FILE_DIR 参数
   • 确保该参数指向正确的持久化存储路径

2. 权限配置：

   • 对上传目录执行 chmod 777 命令
   • 确保 Send 服务有足够的权限写入目标目录

3. 存储验证：

   • 确认 Docker 卷挂载配置正确
   • 检查上传目录是否确实位于持久化存储而非临时文件系统

技术背景

Mozilla Send 的文件处理机制会根据配置决定文件存储位置：

• 生产环境推荐使用 S3 存储
• 本地存储时依赖正确的目录配置
• 当存储配置异常时，系统可能回退到内存存储

最佳实践建议

为避免类似问题，建议：

1. 定期检查服务日志中的存储相关警告
2. 对重要上传目录设置监控告警
3. 考虑使用专业存储解决方案如 S3
4. 在系统资源使用异常时及时排查存储配置

通过以上措施，可以确保 Mozilla Send 服务稳定处理大文件上传，避免因存储配置问题导致的服务中断。