图片上传接口返回400因前端未用multipart/form-data提交或字段名不匹配；需确保enctype属性、Postman配置正确，避免FormFile与PostForm混用，并通过读取文件头校验真实MIME类型及大小。
图片上传接口为什么总是返回400？检查 multipart/form-data 和 c.FormFile() 的配合
Gin 默认不自动解析 multipart 表单，但 c.FormFile() 会尝试从原始请求体中提取文件字段——前提是前端确实以 multipart/form-data 提交，且字段名与后端代码一致。
常见错误是前端用 JSON 发送二进制数据，或漏传 name="file"（假设后端写的是 c.FormFile("file")），导致 err != nil 且错误信息为 http: no such file。
- 确保 HTML 表单含
enctype="multipart/form-data" - Postman 测试时选 “form-data”，Key 填
file，Value 选文件 - 不要在同个请求里既调
c.FormFile()又调c.PostForm()—— Gin 的底层 reader 只能读一次，后者会导致前者失效
保存图片前必须校验文件类型和大小，别只信 Header.Filename
Header.Filename 是客户端传来的字符串，可伪造；真正可靠的是 Header.Header.Get("Content-Type") 或读取文件头（magic bytes）。Gin 不提供内置 MIME 检查，得自己加。
示例逻辑：先用 file, header, err := c.Request.FormFile("file") 获取句柄，再读前 512 字节判断类型：
立即学习“go语言免费学习笔记（深入）”；
buf := make([]byte, 512) _, _ = file.Read(buf) mimeType := http.DetectContentType(buf)
然后对比白名单：mimeType == "image/jpeg" || mimeType == "image/png"。同时限制总大小（如 c.Request.ContentLength ），避免内存爆掉。
- 别用
header.Size做唯一依据——它只是 Content-Length 声称的值，不可信 - 保存路径建议用哈希（如
md5.Sum(file).String()[:12]）+ 原扩展名，避免重名和路径遍历 - 写入磁盘前记得
os.MkdirAll(dir, 0755)，否则os.Create会报no such file or directory
图片访问 404？静态文件路由和真实路径要严格匹配
Gin 的 c.StaticFS("/static", http.Dir("./uploads")) 仅映射 URL 路径到本地目录，但不会自动处理子目录或缺失文件。如果图片存放在 ./uploads/2024/06/abc.jpg，而你注册的是 /static → ./uploads，那么访问 /static/2024/06/abc.jpg 才对得上。
- URL 中的路径层级必须和磁盘实际路径完全一致，少一级或多一级都 404
- 不要在
StaticFS路径末尾加斜杠（如"./uploads/"），Go 的http.Dir对末尾斜杠敏感 - 开发时可用
os.Stat(path)打印日志验证文件是否存在，比猜快得多
删除图片时为何删不掉？注意文件句柄未关闭和 Windows 锁定问题
如果上传后没显式关闭 file 句柄（defer file.Close()），Windows 下可能因文件被占用而删失败，错误是 The process cannot access the file because it is being used by another process。
更隐蔽的问题是：Gin 处理完上传后，若图片被其他 goroutine（比如缩略图生成）仍在读取，os.Remove() 就会失败。没有“强制删除”这种事，只能等资源释放。
- 所有
os.Open/c.Request.FormFile后必须配defer xxx.Close() - 删除前先
os.Stat()确认文件存在，避免误删提示干扰判断 - 生产环境建议用原子操作：先
os.Rename(old, tmp)再os.Remove(tmp)，减少竞态窗口
路径拼接、并发读写、Windows 文件锁——这些不是 Gin 的问题，但它们会在你写完 upload/delete 接口后突然冒出来，而且不会报错，只会静默失败或延迟生效。
