Beego框架下大文件的后台异步打包与下载通知-Golang-PHP中文网

beego 中 savetofile 同步写入会阻塞 http 请求，正确做法是校验后立即返回任务 id，用后台 goroutine 流式处理文件、记录状态并清理临时资源，下载时需显式设置 content-disposition 头。

beego框架下大文件的后台异步打包与下载通知

Beego 中直接用 `SaveToFile` 处理大文件会阻塞 HTTP 请求

Beego 的 SaveToFile 是同步写入，调用时会一直占用当前 goroutine 和 HTTP 连接，直到文件写完。对几百 MB 以上的文件，这会导致超时、内存暴涨、甚至整个服务响应变慢。

真正可行的做法是：接收上传请求后，立即返回任务 ID，把保存/打包逻辑扔进后台 goroutine 执行，并用 context 控制超时（比如 15 分钟）。

上传接口只校验文件名、Content-Length、MIME 类型，不读取 Body 全体
用 f.GetFile("file") 拿到 multipart.File 后，立刻 defer file.Close()，但不要调 SaveToFile
把 file 和元数据传给后台 goroutine，用 io.Copy 流式写入磁盘或对象存储，避免全量加载
记录任务状态到数据库或内存 map（如 map[string]string{"task_abc": "processing"}），供后续轮询查状态

异步打包完成后如何可靠通知前端？别依赖已关闭的 HTTP 连接

用户点击“开始打包”后页面可能已刷新或关闭，此时 HTTP 响应早已结束。notifyUser() 如果还试图往原始 f.Ctx.ResponseWriter 写东西，会 panic 或静默失败。

可靠通知只有三种落地方式，按实时性排序：

WebSocket 推送：需在用户登录/进入页面时建立连接，并将 *websocket.Conn 绑定到 userID 或 sessionID；推送前检查 conn.WriteDeadline 是否过期，否则先 conn.SetWriteDeadline
前端轮询 API：提供 GET /api/task/status?task_id=xxx，后端返回 {"status":"done","download_url":"/downloads/xxx.zip"}；注意加缓存控制头（Cache-Control: no-cache），避免浏览器缓存旧结果
邮件/SMS：适合超大文件（>2GB）或离线场景，调用 SendGrid、阿里云短信 SDK 等，失败要重试 + 记日志

静态资源路径配置不当导致下载链接 404 或被直接渲染

Beego 默认不自动处理文件下载头，即使你把 ZIP 放进 ./staticfiles 并用 web.SetStaticPath("/staticfiles", "./staticfiles") 暴露，浏览器仍可能尝试打开 ZIP 而非下载——因为响应缺少 Content-Disposition: attachment; filename="xxx.zip"。

Beego框架 2.3.5

Beego框架 2.3.5 版本源码包下载，适合关注表单空值、函数注释名和 nil 返回值修复的 Go Web 开发者。

下载

正确做法不是靠静态路径直出，而是用控制器显式设置头：

func (c *FileController) Download() {
    taskID := c.GetString("task_id")
    filePath := "/path/to/" + taskID + ".zip"
    f, err := os.Open(filePath)
    if err != nil {
        c.Abort("404")
        return
    }
    defer f.Close()

    c.Ctx.ResponseWriter.Header().Set("Content-Type", "application/zip")
    c.Ctx.ResponseWriter.Header().Set("Content-Disposition", `attachment; filename="`+taskID+`.zip"`)
    c.Ctx.ResponseWriter.Header().Set("Content-Transfer-Encoding", "binary")
    c.Ctx.ResponseWriter.Header().Set("Content-Length", strconv.FormatInt(fileInfo.Size(), 10))

    io.Copy(c.Ctx.ResponseWriter, f)
}

注意：Content-Length 必须设对，否则 Chrome 可能显示“已损坏”，且不能和 gzip 中间件共用（Beego 默认不 gzip 二进制流，但若全局启用了压缩中间件，需排除 /download/* 路由）。