Beego 中 GetFile 返回 nil 的常见原因：请求未使用 multipart/form-data 类型、表单字段名不匹配、app.conf 未启用 EnableFileUpload = true、Beego 2.x 中未提前调用 ctx.ParseForm() 或在 Prepare 阶段过早调用。
Beego 中 GetFile 返回 nil 的常见原因
调用 GetFile 拿不到文件对象，大概率不是代码写错了，而是请求根本没走对路：Beego 默认只解析 Content-Type: multipart/form-data 的 POST 请求，且要求表单字段名与 GetFile("xxx") 中的字符串完全一致（区分大小写）。如果前端用 fetch 或 axios 发送 JSON 数据、或漏传 enctype="multipart/form-data"，GetFile 就会返回 nil。
实操建议：
- 用浏览器开发者工具检查 Network → Payload，确认请求头含
Content-Type: multipart/form-data; boundary=... - 检查 HTML 表单是否写了
<form enctype="multipart/form-data"> - 后端加一行日志：
ctx.Input.RequestBody打印原始 body，若为空或明显是 JSON 字符串，说明前端没发对格式 - Beego 2.x 要求在
app.conf中显式开启文件上传支持：EnableFileUpload = true（默认为 false）
GetFile 和 GetFiles 的使用差异
GetFile 用于单文件上传，返回一个 *multipart.FileHeader；GetFiles 用于多文件同名字段（如 <input type="file" name="images" multiple>），返回 []*multipart.FileHeader。两者都依赖 Beego 已完成的 form 解析，不能在 Prepare 阶段之前调用。
实操建议：
- 单文件用
f, h, err := ctx.GetFile("avatar")，其中f是可读流，h含Filename、Size、Header等元信息 - 多文件必须用
fhList := ctx.GetFiles("files")，遍历处理每个fh，再逐个调用ctx.GetFile("files")会出错（因为内部索引已移位） -
h.Size是上传前客户端上报的大小，不可信；实际读取时需用io.Copy并校验字节数，防止恶意构造超大Size
保存上传文件时要注意的路径与权限问题
Beego 不自动创建目录，也不处理文件名安全。直接拼接 filepath.Join("uploads", h.Filename) 很危险——攻击者可能传 ../../etc/passwd 触发路径穿越。
实操建议：
- 用
path.Base(h.Filename)提取纯文件名，丢弃所有路径部分 - 生成唯一文件名：
uuid.New().String() + filepath.Ext(h.Filename)，避免覆盖和冲突 - 保存前确保目录存在：
os.MkdirAll("uploads", 0755)；注意 Go 进程对目标目录要有写权限 - 不要把上传目录放在
static/下直接暴露，应通过控制器路由中转提供下载，或配置 Web 服务器限制访问
Beego 1.x 与 2.x 在文件上传上的关键区别
Beego 2.x 移除了全局 MaxMemory 配置，改由 context.Context 实例控制内存缓冲上限；同时 GetFile 内部不再自动调用 ParseMultipartForm，必须确保请求已解析（通常在 Post 方法内自然触发，但自定义 Prepare 逻辑时需手动调用 ctx.ParseForm()）。
实操建议：
- Beego 2.x 中，若在
Prepare里提前访问GetFile，务必先调用ctx.ParseForm()，否则返回nil - 限制单文件大小应在控制器中判断
h.Size，Beego 不提供类似MaxUploadSize的中间件级限制（需自行封装） - Beego 1.x 的
beego.BConfig.MaxMemory对应 2.x 的ctx.Input.SetMaxMemory(1 （64MB），但仅影响 form 解析内存，不影响文件流读取
