上传目录必须显式创建且有写权限，Echo不自动创建路径；os.OpenFile或os.Create在目录不存在时返回no such file or directory；应使用os.MkdirAll确保路径存在并设置合适权限，避免硬编码路径。
上传目录必须显式创建且有写权限
Echo 本身不自动创建上传路径，os.OpenFile 或 os.Create 在目标目录不存在时会直接报 no such file or directory。常见错误是只写了 ./uploads 却没执行 mkdir -p ./uploads，或部署到 Linux 服务器后用 root 启动但工作目录属主是普通用户，导致进程无权写入。
实操建议：
- 启动服务前用
os.MkdirAll("./uploads", 0755)确保目录存在（注意权限：0755 允许进程写，但不要设 0777） - Linux 部署时统一用非 root 用户运行，比如
useradd -r -s /bin/false echoapp，再chown -R echoapp:echoapp ./uploads - 避免硬编码路径，从环境变量读取：
uploadDir := os.Getenv("UPLOAD_DIR")，本地开发设UPLOAD_DIR=./uploads，生产环境设/var/www/uploads
用 c.FormFile 获取文件并校验基础安全项
c.FormFile("file") 是 Echo 解析 multipart 表单的标准方式，但它只返回 *multipart.FileHeader，不包含文件内容——真正读取要靠 header.Open()。很多新手误以为拿到 header 就等于文件已落地，结果在后续处理中才发现磁盘上根本没有文件。
实操建议：
- 必须检查
err != nil和header.Size > 10*1024*1024（例如限制 10MB），否则可能被恶意大文件耗尽内存或磁盘 - 用
filepath.Ext(header.Filename)提取扩展名，拒绝.php、.sh等可执行后缀（仅靠前端校验不可信） - 重命名文件名，避免原始名含
../或控制字符：safeName := fmt.Sprintf("%s-%d%s", uuid.NewString(), time.Now().UnixNano(), ext)
保存文件时务必用 io.Copy 而非 io.ReadAll
有人图省事把整个文件读进内存再写磁盘：data, _ := io.ReadAll(src) → os.WriteFile(path, data, 0644)。这在上传 100MB 视频时会瞬间吃光 Go 进程的堆内存，触发 GC 频繁或 OOM kill。
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
实操建议：
- 始终用
dst, err := os.Create(filepath.Join(uploadDir, safeName))+io.Copy(dst, src)流式写入 - 关闭资源：用
defer dst.Close()，但注意如果io.Copy出错，dst可能已部分写入，需加os.Remove清理 - 写入后调用
dst.Sync()（可选），确保数据落盘，尤其对关键业务如合同扫描件
生产环境必须禁用静态文件自动暴露
Echo 的 e.Static("/uploads", "./uploads") 会让所有 /uploads/xxx.jpg 直接返回文件，但这也意味着攻击者可尝试访问 /uploads/.env 或 /uploads/backup.zip——只要这些文件意外落在同一目录下。
实操建议：
- 绝不使用
Static暴露上传目录；改用路由手动控制：e.GET("/uploads/:filename", serveUploadedFile) - 在
serveUploadedFile中先校验c.Param("filename")是否匹配白名单正则（如^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}-\d+\.(jpg|png|pdf)$） - 用
http.ServeFile(c.Response(), c.Request(), fullPath)返回，而非c.File()，前者更可控且不自动设置 Content-Disposition
目录管理真正的难点不在创建和保存，而在于生命周期——上传后谁来删？过期文件怎么清理？是否要支持断点续传或分片？这些不会因用了 Echo 就自动解决，得结合业务节奏设计清理策略或引入对象存储。
