move_uploaded_file() 不能直接拼接 "uploads/2026/09/28/" 类路径，因其不自动创建目录，且日期子目录可能不存在、并发 mkdir 竞态失败、权限不足；必须预先用 mkdir() 确保父目录存在并可写，再调用该函数。

为什么不能直接用 move_uploaded_file() 写死路径

直接拼接 "uploads/2026/09/28/" 这类路径看似简单，但容易出问题：日期目录可能不存在、并发上传时 mkdir 竞态失败、权限不足导致写入失败。更关键的是，move_uploaded_file() 不接受目录不存在时自动创建的语义，它只负责“移动”，不负责“建目录”。

用 os.MkdirAll() 预创建日期子目录

必须在调用 c.FormFile() 后、file.Open() 前，先确保目标路径存在。推荐按年/月/日三级结构，既避免单目录文件过多，又保留时间维度可追溯性。

Echo框架 5.1.0

Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。

下载

• 用 time.Now().Format("2006/01/02") 生成标准日期字符串（Go 的时间格式化是固定字符串，不是占位符）
• 拼接完整路径后，立即调用 os.MkdirAll(uploadDir, 0755)，第二个参数是权限掩码，0755 比 0777 更安全
• 检查返回 error，如果 mkdir 失败（比如磁盘满、无写权限），应提前返回 HTTP 错误，而不是等到 move 时才崩

构造安全文件名并完成移动

日期目录只是第一层隔离，文件名仍需防覆盖和路径遍历。不要信任 file.Filename 的原始值。

• 用 path.Base(file.Filename) 剥离可能含路径的恶意文件名（如 ../../etc/passwd.jpg）
• 用 strings.ToLower(path.Ext(filename)) 统一扩展名大小写，避免 .JPG 和 .jpg 被当成不同类型
• 生成唯一前缀（如 uuid.NewString() 或 time.Now().UnixNano()），组合为 uploadDir + "/" + uuid + ext
• 调用 src, _ := file.Open() 获取 reader，再用 ioutil.WriteFile() 或 os.Create() + io.Copy() 写入，比 move_uploaded_file()（PHP 专属）更可控

注意 c.FormFile() 的临时文件生命周期

Echo 的 c.FormFile() 返回的 *multipart.FileHeader 只包含元信息和临时路径，其底层文件在请求结束时会被自动清理。如果你没在 handler 返回前完成读取或移动，文件就丢了。

• 不要在 goroutine 里异步处理上传文件——临时文件可能已被删
• 不要只校验 file.Size 就返回成功，必须确认 io.Copy() 写入字节数与原 size 一致
• 大文件（>10MB）建议加 middleware.BodyLimit("10MB")，防止恶意上传耗尽内存

日期分目录本身不难，难的是把时间格式、目录创建、文件名净化、临时文件生命周期这四件事串成原子操作。漏掉任意一环，上线后都可能表现为“有时能传，有时 500”或者“文件莫名消失”。