Beego中Controller通过GetFile()接收上传文件，需确保表单enctype="multipart/form-data"，该方法返回*multipart.FileHeader含Filename、Size等信息，调用前不可先调ParseForm()。
Beego 中 Controller 怎么接收上传的文件
Beego 的文件上传入口在 Controller 实例的 GetFile() 方法，它直接封装了 http.Request 的底层 multipart 解析逻辑。调用前必须确保请求是 POST 且 Content-Type 为 multipart/form-data，否则 GetFile() 返回 nil 且不报错。
常见错误现象：前端表单漏写 enctype="multipart/form-data"，导致后端收不到文件，GetFile("xxx") 返回 nil，但 GetString("xxx") 可能意外读到空字符串或原始二进制乱码。
- 使用场景：通常搭配表单字段名（如
"upload"）调用ctrl.GetFile("upload") - 返回值是
*multipart.FileHeader，含Filename、Size、Header等元信息 - 不要在调用
GetFile()前调用ParseForm()—— Beego 已自动处理，重复解析会清空文件句柄
怎么把上传的文件保存到服务器指定路径
GetFile() 返回的 *multipart.FileHeader 提供了 Open() 方法，可得到一个 io.ReadCloser，配合 os.Create() 和 io.Copy() 即可完成保存。关键点在于路径拼接和权限控制。
容易踩的坑：直接用前端传来的 Filename 拼路径，可能引发路径遍历（如 ../../etc/passwd）或文件名注入（含特殊字符、空格、中文编码问题）。
立即学习“go语言免费学习笔记（深入）”；
- 务必对
Filename做白名单过滤：只保留字母、数字、下划线、短横线和点，例如用正则^[a-zA-Z0-9._-]+$ - 保存路径建议用
path.Join()拼接，避免手动拼斜杠；目标目录需提前os.MkdirAll()创建并设好权限（如0755） - 示例：
file, header, err := ctrl.GetFile("upload") if err != nil { ctrl.Data["json"] = map[string]interface{}{"error": "no file received"} ctrl.ServeJSON() return } dst, _ := os.Create(path.Join("./uploads", sanitizeFilename(header.Filename))) defer dst.Close() io.Copy(dst, file)
Beego 的 MaxMemory 和 MaxUploadSize 怎么配才不爆内存
Beego 默认限制单个请求内存占用为 64MB（MaxMemory），上传大文件时若全部载入内存再写盘，极易 OOM。而 MaxUploadSize 是全局最大上传体积（单位字节），两者必须协同设置。
性能影响明显：若 MaxMemory 过小（如 1MB），即使文件只有 5MB，Beego 也会强制走临时磁盘缓存，拖慢速度；若过大（如 512MB），并发上传多路大文件就可能耗尽服务内存。
-
MaxMemory推荐设为10 （约 10MB），足够应对多数场景又留出安全余量 -
MaxUploadSize应略大于MaxMemory，例如设为50 （50MB），避免因内存阈值触发不必要的磁盘中转 - 配置位置：在
app.conf中写maxmemory = 10485760和maxuploadsize = 52428800，注意单位是字节
上传成功后怎么返回标准 JSON 结构给前端
Beego 的 ServeJSON() 默认会设置 Content-Type: application/json 并序列化数据，但要注意结构体字段必须首字母大写（否则 JSON 序列化为空对象），且建议显式控制状态码。
容易被忽略的地方：上传失败时若只返回 500，前端难区分是服务崩溃还是校验失败；文件名含中文时未做 UTF-8 编码，可能在某些客户端显示乱码。
- 推荐统一返回字段：
code（整数状态）、message（提示）、data（上传后文件信息，含url或name） - 失败时用
ctrl.Abort("400")或ctrl.Abort("413")显式设 HTTP 状态码，比全用200+ 错误code更利于前端拦截 - 文件名若需返回给前端展示，先用
url.PathEscape()编码，避免 URL 解析异常
