Revel中需手动解析c.Params.Files中的multipart.FileHeader，调用Open()和io.Copy保存文件，注意校验文件名、路径安全及请求体大小限制。
Revel 中如何接收 multipart/form-data 请求
Revel 默认能解析 multipart/form-data，但不会自动保存上传文件——它只把原始数据挂到 c.Params.Files（类型为 map[string][]*multipart.FileHeader）里。你得自己调用 fileHeader.Open() 和 io.Copy() 才能把内容落地。别指望像 Laravel 的 $request->file()->store() 那样一行搞定。
常见错误现象：
- 直接读
c.Params.Files["file"]却没调.Open()，结果拿到空内容 - 用
c.Params.Get("file")试图取文件名或内容，返回的是字符串（表单字段值），不是文件对象 - 没检查
len(c.Params.Files["file"]) == 0就直接取索引，panic
实操建议：
- 先确认前端
<form>有enctype="multipart/form-data" - 用
c.Params.Files["avatar"]获取文件头列表，再对每个*multipart.FileHeader调用Open()得到multipart.File - 用
os.Create()或ioutil.WriteFile()（Go 1.16+ 推荐os.WriteFile）写入目标路径
怎么安全地保存上传的文件到磁盘
Revel 没内置存储驱动（比如 Laravel 的 Storage::disk('public')），所有路径都得手动拼、手动校验。最容易踩的坑是目录遍历攻击：如果用户传个文件名叫 ../../etc/passwd，又没过滤，就可能被写到系统关键位置。
实操建议：
- 永远不要直接使用
fileHeader.Filename作为保存名；用filepath.Base(fileHeader.Filename)截掉路径部分 - 生成唯一文件名（比如
uuid.New().String() + filepath.Ext(fileHeader.Filename)），避免覆盖和冲突 - 保存路径必须是绝对路径且限定在应用可控目录内，例如
filepath.Join(revel.BasePath, "uploads", filename) - 创建父目录前先检查是否存在，用
os.MkdirAll(dir, 0755)，别假设 uploads 目录已存在
如何处理多文件上传与文件夹结构还原
Revel 原生不支持 webkitdirectory —— 它只认标准 <input type="file" multiple>。如果你需要上传整个文件夹（含子目录），前端必须自己遍历 event.target.files 并提取每个 file.webkitRelativePath，再把该路径作为额外字段（如 relpath）随每个文件一起发过来。
后端就得配合解析这个字段，构造完整目标路径：
relPath := c.Params.Get("relpath") // 如 "docs/config.json"
targetPath := filepath.Join(uploadRoot, relPath) // 自动带目录层级
os.MkdirAll(filepath.Dir(targetPath), 0755)
注意点：
-
relpath是前端传的，不可信，必须做白名单校验（比如只允许字母、数字、/、.、-、_） - 不能让
relpath以../开头，否则可能逃逸出根目录 - Revel 不会帮你做并发写保护，多个文件同时上传时，确保
os.MkdirAll和os.Create是线程安全的（Go 标准库本身是）
为什么上传大文件容易失败，以及怎么调优
Revel 底层用 Go net/http，默认限制请求体最大为 10MB（http.MaxBytesReader 未显式设置时的行为）。超过就直接 400 Bad Request，连控制器都进不去，日志里也看不到明显提示。
实操建议：
- 在
app/init.go的FilterConfigurations前加一段初始化代码，调大http.MaxBytesReader的上限 - 更稳妥的做法是在
revel.AppConfig里配置自定义 limit，然后在自定义 Filter 中用http.MaxBytesReader包裹c.Request.Body - 生产环境务必配合 Nginx 设置
client_max_body_size，否则请求根本到不了 Revel - 上传过程无进度反馈，如需断点续传或分片，得自己基于
Range请求头实现，Revel 不提供现成支持
真正麻烦的不是“怎么传”，而是“传完之后怎么防重复、怎么查毒、怎么转存对象存储、怎么通知下游”——这些 Revel 一概不管，得你自己在 Controller 里串起来。别把它当 Laravel 或 ASP.NET Core 那种开箱即用的框架来用。
