c.FormFile拿不到文件主因是前端未正确发送multipart/form-data请求：表单缺enctype="multipart/form-data"、字段名与c.FormFile("xxx")不一致，或用fetch/axios时未用FormData提交。
为什么 c.FormFile 拿不到文件？
常见现象是调用 c.FormFile("file") 返回 nil, err != nil，错误信息类似 http: no such file 或直接 panic。根本原因不是代码写错，而是前端没发对——multipart/form-data 表单缺失或字段名不匹配。
必须确认三点：
- HTML 表单的
enctype属性明确设为"multipart/form-data"，不能省略或写成application/x-www-form-urlencoded -
input[type="file"]的name属性值（如name="avatar"）要和后端c.FormFile("avatar")中的字符串完全一致，区分大小写 - 如果用 fetch / axios 提交，不能直接传 JSON 对象；得用
FormData实例，并确保文件 Blob 已正确 append，例如fd.append("file", input.files[0])
如何安全保存上传的文件到指定目录？
拿到 *multipart.FileHeader 后，不能直接用 header.Filename 作本地路径名——它来自客户端，可能含 ../、空字节或非法字符，有路径遍历风险。
推荐做法是丢弃原始文件名，生成唯一 ID 作为存储名：
Echo框架 5.1.0
下载
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
- 用
filepath.Base(header.Filename)截取原始文件名，再用strings.ReplaceAll清除危险字符（如..、/、\0） - 更稳妥的是用
uuid.NewString()+filepath.Ext(header.Filename)组合新文件名，例如"a1b2c3d4.jpg" - 保存前务必检查目标目录是否存在，用
os.MkdirAll("./uploads", 0755)创建，权限不要设成0777 - 打开文件用
header.Open()，写入用io.Copy(dst, src)，别用ioutil.ReadAll加载整个文件到内存，大文件会 OOM
怎么限制上传文件大小和类型？
Echo 默认不限制请求体大小，超大上传会卡住或触发 http: request body too large 错误。必须在路由前加中间件控制：
- 全局限制：在
e := echo.New()后立刻设置e.MaxRequestBodySize = 10 * 1024 * 1024（10MB） - 单路由限制：用
echo.MiddlewareFunc包裹 handler，在里面读取c.Request().ContentLength并对比阈值，超限就返回413 Payload Too Large - 类型校验不能只看
header.Header.Get("Content-Type")，它可被伪造；应读取文件前几个字节做 magic number 检查，比如 JPEG 是0xFF 0xD8，PNG 是0x89 0x50 0x4E 0x47 - 扩展名白名单（如
map[string]bool{".jpg": true, ".png": true}）必须配合 magic number，二者缺一不可
上传成功后如何返回结构化响应？
别直接 c.String(200, "ok")。前端需要明确的字段来更新 UI 或跳转，比如文件 URL、大小、ID。
- 返回 JSON 是标准做法：
c.JSON(200, map[string]interface{}{"url": "/static/uploads/" + newFilename, "size": header.Size, "id": id}) - 注意
url字段要是可访问的静态路径，需提前注册静态文件服务：e.Static("/static/uploads", "./uploads") - 如果文件要存数据库，建议把保存操作和 DB 插入放在同一事务中（如用
sql.Tx），避免文件写入成功但元数据入库失败导致脏数据 - 响应里别暴露绝对路径、服务器用户名等敏感信息，
header.Filename即使清洗过也不建议原样返回给前端
最易被忽略的是并发写入时的文件名冲突——即使用了 UUID，若多个请求几乎同时上传，仍可能因系统时间精度或随机数种子问题产生重复。真正在生产环境用，得加一层原子文件重命名或数据库唯一索引兜底。
