Gin 文件上传接口返回400或空文件是因为未正确解析 multipart/form-data，需确保表单 name 与 FormFile 参数一致、避免中间件提前读取 Body，并在必要时手动调用 ParseMultipartForm。
文件上传接口为什么总是返回400或空文件？
Gin 默认不自动解析 multipart/form-data，c.FormFile 会直接报错或返回 nil，必须显式调用 c.Request.ParseMultipartForm 或依赖 Gin 的自动解析逻辑——但前提是表单字段名和路由匹配正确。
- 确保 HTML 表单中
<input type="file" name="file">的name值与 Go 中c.FormFile("file")的参数一致 - 不要在上传路由上加中间件（如 JWT 验证）后遗漏
c.Request.Body的读取权限；Gin 的FormFile内部会重置 body，但某些自定义中间件可能提前消费了流 - 上传前检查
c.Request.MultipartForm是否为 nil；若为 nil，手动调用c.Request.ParseMultipartForm(32 （32MB 限制），否则 <code>FormFile返回nil, err
如何安全地保存上传的文件并避免路径遍历？
用户传来的 filename 可能含 ../、空字节或控制字符，直接拼接 os.OpenFile(uploadDir + "/" + filename, ...) 会导致任意文件写入。
- 用
filepath.Base(filename)提取纯文件名，丢弃所有路径成分 - 生成唯一文件名：结合
uuid.New().String()和原始扩展名（用filepath.Ext(original)安全提取） - 保存前检查目标目录是否存在，用
os.MkdirAll(uploadDir, 0755)创建，不要依赖前端或固定路径 - 禁止对上传文件执行
exec.Command或template.Parse—— 即使是 .txt 也可能含恶意内容
下载文件时为什么浏览器不弹保存框或返回 404？
c.File(filepath) 要求路径绝对且文件必须存在；相对路径、符号链接未解、权限不足都会静默失败或返回 404，而 c.Header("Content-Disposition", "attachment; filename=...") 不生效是因为 Gin 已内部设置 header。
- 先用
os.Stat(path)检查文件是否存在且可读，不存在则c.AbortWithStatus(404) - 用
filepath.Join(uploadDir, filepath.Base(filename))拼接路径，避免用户传入../../etc/passwd - 如果需自定义文件名（如下载时重命名），用
c.Header("Content-Disposition", "attachment; filename=\""+safeName+"\"")+c.Data(...)手动写入，而不是c.File - 大文件别用
c.File，改用http.ServeFile(c.Writer, c.Request, path)或流式io.Copy避免内存暴涨
列出目录文件时如何防止目录穿越和性能卡顿？
filepath.Walk 或 os.ReadDir 若不限制深度或路径范围，可能暴露系统目录，且无分页时加载几千个文件会让 HTTP 连接超时。
立即学习“go语言免费学习笔记（深入）”；
- 只允许列出预设的上传目录子集，例如
allowedDirs := map[string]bool{"uploads": true}，拒绝任何不在其中的dir参数 - 用
os.ReadDir替代filepath.Walk，仅读一层，避免递归遍历整个磁盘 - 加限流：对单次请求最多返回 100 条，用
limit, _ := strconv.Atoi(c.DefaultQuery("limit", "50"))控制 - 文件名过滤掉以
.开头的（如.gitignore），避免泄露配置文件
实际部署时，上传目录不能放在 web root 下，也不能设为 Go 二进制可写以外的权限；Nginx 前置时注意 client_max_body_size 和 proxy_buffering off 对大文件的影响。
