beego中parseform()必须在读取文件前调用，否则ctx.input.files为空；需配置maxmemory和maxuploadsize，并用ctx.input.getfiles()+file.open()安全处理文件，返回json须调用ctx.servejson(true)。
Beego 中 ctx.Input.ParseForm() 必须在读取文件前调用
很多开发者上传图片时遇到 ctx.Input.Files 为空，根本原因是没按 Beego 的文件解析顺序操作。Beego 要求必须先调用 ctx.Input.ParseForm()，才能触发 multipart 表单解析，否则 ctx.Input.Files 和 ctx.Input.RequestBody 都无法正常访问。
常见错误写法是直接调用 ctx.Input.GetFiles("image") 而跳过解析步骤，结果返回空切片且无报错，极难排查。
- 务必在控制器方法开头第一行（或至少在任何文件操作前）调用
err := ctx.Input.ParseForm() - 检查
err是否为nil，非 nil 通常意味着请求体不是合法的multipart/form-data或超出了MaxMemory限制 - Beego 默认只解析内存中不超过 64MB 的表单数据，大文件需提前配置
MaxMemory（见下文）
配置 MaxMemory 和 MaxUploadSize 防止上传失败
Beego 不会自动拒绝超大文件，而是会在解析阶段静默截断或报错，比如出现 http: request body too large 或 multipart: message too large。这些错误不会进入控制器逻辑，而是由底层 HTTP server 拦截，所以日志里可能只看到 400 状态码，找不到具体原因。
需要在 app.conf 中显式设置：
MaxMemory = 104857600 # 100MB，单位字节 MaxUploadSize = 104857600
注意：MaxMemory 控制解析时允许加载到内存的最大体积；MaxUploadSize 是 Beego 自定义校验项（需手动在代码中调用 ctx.Input.GetUploadSize() 判断），二者要保持一致或后者 ≤ 前者。
-
MaxMemory过小会导致大文件上传直接 400，不进 controller - Beego 2.x 开始，
MaxUploadSize不再自动生效，必须手动校验：if ctx.Input.GetUploadSize() > 100*1024*1024 { ... } - 生产环境建议同时配 Nginx 的
client_max_body_size，否则请求根本到不了 Beego
用 ctx.Input.GetFiles() + file.Open() 安全读取上传文件
ctx.Input.GetFiles("image") 返回的是 []*multipart.FileHeader，它只是元信息，不包含文件内容。真正读取必须调用 file.Open() 获取 io.ReadSeeker，然后复制到目标位置。
别用 file.Header.Open() 后直接 io.Copy 到磁盘——这会忽略文件名安全校验，容易被构造恶意路径（如 ../../../etc/passwd）。
- 始终用
path.Base(file.Filename)提取原始文件名，丢弃路径部分 - 手动拼接保存路径：
filepath.Join(uploadDir, safeName)，不要直接拼file.Filename - 检查扩展名是否在白名单内（如
["jpg", "jpeg", "png", "gif"]），仅靠 MIME 类型不可信 - 示例片段：
files, _ := ctx.Input.GetFiles("image") for _, file := range files { f, _ := file.Open() defer f.Close() dst, _ := os.Create(filepath.Join("./uploads", path.Base(file.Filename))) io.Copy(dst, f) dst.Close() }
返回 JSON 响应时别漏掉 ctx.ServeJSON() 的参数细节
上传成功后习惯性写 ctx.Data["json"] = map[string]interface{}{...} + ctx.ServeJSON()，但默认行为是加 Content-Type: application/json; charset=utf-8 并调用 json.Marshal。问题在于：如果结构体字段含 time.Time 或自定义类型，会因缺少 JSON tag 或未实现 MarshalJSON 导致空响应或 500 错误。
- 推荐显式传参：
ctx.ServeJSON(true)（第二个参数true表示indent = false，避免空格干扰前端解析） - 确保返回 map 或 struct 所有字段都可 JSON 序列化；时间字段建议转成字符串：
"uploaded_at": time.Now().Format(time.RFC3339) - 不要在
ServeJSON()后再写ctx.StopRun()—— 它已内部调用，重复调用会 panic
Beego 的文件上传链路短但关键点密集，最常出问题的不是业务逻辑，而是 ParseForm 时机、MaxMemory 配置和文件名净化这三个环节。漏掉任意一个，都会导致“接口没报错却传不上去”这类静默失败。
