c.FormFile() 拿不到文件是因为前端未正确发送 multipart/form-data 请求：input 必须有 name="file"，表单 enctype 必须为 multipart/form-data，不可用 JSON；curl 测试需用 -F；默认 4MB 限制，超限静默失败，应调用 e.MaxMultipartMemory() 调整。
为什么 c.FormFile() 拿不到文件？
常见现象是调用 c.FormFile("file") 返回 nil, nil 或报 http: no such file 错误。根本原因不是代码写错，而是前端没发对——multipart/form-data 表单必须带 name="file"（与后端 FormFile 参数一致），且不能用 JSON 请求体发送文件。
实操建议：
- 前端确保
<input type="file" name="file">，表单enctype="multipart/form-data" - 用
curl测试时写全：curl -F "file=@/path/to/a.jpg" http://localhost:8080/upload - Echo 默认限制 4MB 单文件，超限会静默失败；需提前调用
e.MaxMultipartMemory(16 （例如设为 16MB）
如何安全保存上传的文件到磁盘？
直接用 file.Save() 存到固定路径有风险：文件名未清洗、目录未创建、重复名覆盖、路径穿越（如 ../../etc/passwd）。
实操建议：
- 用
filepath.Base(file.Filename)截取原始文件名，再用strings.ReplaceAll()去掉空格和特殊符号 - 生成唯一文件名：组合
uuid.New().String()+ 原扩展名（从mime.TypeByExtension或file.Header.Header.Get("Content-Type")提取） - 目标路径用
filepath.Join(uploadDir, safeName)，上传前用os.MkdirAll(uploadDir, 0755)确保目录存在 - 务必检查
file.Size是否超出业务允许上限（比如头像 ≤2MB，文档 ≤50MB），超限直接return c.String(400, "file too large")
怎么防止恶意文件执行或解析？
仅校验扩展名毫无意义——攻击者可把木马改成 shell.php.jpg；关键在内容检测和存储隔离。
Echo框架 5.1.0
下载
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
实操建议：
- 对图片类文件，用
image.DecodeConfig()尝试解析头部，失败即拒绝 - 对 PDF/Office 文档，可用
mimetype := mime.TypeByExtension(filepath.Ext(filename))初筛，但必须配合file.Header.Header.Get("Content-Type")双比对 - 上传目录**不要**放在 Web 根目录下（如
./public/uploads），应置于项目外或加 Nginx 层禁止直接访问（location /uploads { deny all; }） - Linux 下可给上传目录设置
noexec挂载选项，彻底阻断二进制执行
要不要用 c.MultipartForm()？什么场景才需要？
c.MultipartForm() 是当你必须同时处理多个文件、多个同名字段、或需要读取所有表单值（包括非文件字段）时才用。90% 的单文件上传场景，c.FormFile() 更轻量、更可控。
实操建议：
- 只传一个文件 + 几个文本字段？用
c.FormFile()+c.FormValue("title")足够 - 要批量上传（如
<input type="file" name="files" multiple>）？必须用c.MultipartForm()，然后遍历form.File["files"] - 调用
c.MultipartForm()后，不能再调用c.FormFile()，否则会报http: multipart: NextPart: EOF - 记得在处理完后调用
form.RemoveAll()清理临时文件，否则磁盘会被填满
文件上传真正的复杂点不在 Echo 框架本身，而在边界控制：文件来源可信度、存储路径权限、内容真实性验证、清理机制是否可靠。少一个环节，就可能变成 RCE 或 DoS 入口。
