Beego框架配合Nginx解决大文件上传超时策略-Golang-PHP中文网

beego 项目在 nginx 前置时上传大文件失败，主因是 nginx 与 beego 的超时及大小限制未同步；需同时调整 nginx 的 client_max_body_size 和 beego 的 maxmemory、maxuploadsize 配置。

beego框架配合nginx解决大文件上传超时策略

Beego 项目在 Nginx 前置时上传大文件失败，90% 是因为 Nginx 和 Beego 两层超时与大小限制没对齐，不是单改一个 client_max_body_size 就能解决的。

Beego 默认对 multipart 请求体有硬性拦截：即使 Nginx 放开了，Beego 仍会拒绝超过 MaxMemory 或 MaxUploadSize 的请求。它不读取 PHP 那类 ini 设置，所有限制都在代码或配置文件里。

MaxMemory 控制内存缓冲上限（单位字节），默认 64 （64MB），超出会写临时文件；设为 <code>0 表示不限内存缓冲（慎用）
MaxUploadSize 是总请求体大小上限（含所有字段+文件），单位字节，**必须 ≥ Nginx 的 client_max_body_size**，否则直接返回 400

在 conf/app.conf 中配：

MaxMemory = 104857600  # 100MB
MaxUploadSize = 2147483648  # 2GB

若用代码初始化（如 bee run 启动前），需调用 beego.BConfig.MaxMemory 和 beego.BConfig.MaxUploadSize

不能只在 http 或 server 块里全局设——Beego 的上传接口路径（比如 /api/upload）往往和普通 API 混在一个 server 下，全局放宽会扩大攻击面。

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

匹配 Beego 上传路由的 location 必须显式声明：

location /api/upload {
    client_max_body_size 2g;
    client_body_timeout 600;
    proxy_pass http://backend;
}

Beego 处理大文件常涉及解压、校验、分块入库等操作，响应不是“立刻吐出”，proxy_read_timeout 设短了就会 504；设太长又拖住 worker。它和 Beego 的 RunMode 和业务逻辑强相关。

先用 curl -w "@format.txt" -o /dev/null -s http://localhost:8080/api/upload 测 Beego 单机 P95 响应时间（format.txt 含 %{time_starttransfer}）
若测出是 210s，就设 proxy_read_timeout 252;（+20% 余量）
流式上传（如边收边转码）必须关缓冲：proxy_buffering off;，否则 Nginx 会等整个响应结束才发回，导致前端卡死
别漏掉 proxy_connect_timeout 15; 和 proxy_send_timeout 60;，它们影响连接建立和请求下发，但一般不用拉得比 read 更长

Beego 接收大文件时，Nginx 先存临时文件再转发，这个过程失败不会报 413 或 504，而是静默 500 或日志里出现 open() "/tmp/nginx/client_body/..." failed (13: Permission denied)。

确认 client_body_temp_path 目录存在且 Beego 进程用户（如 www-data）有读写权限：

sudo mkdir -p /var/tmp/nginx/client_body
sudo chown www-data:www-data /var/tmp/nginx/client_body
sudo chmod 755 /var/tmp/nginx/client_body

在 Nginx 配置中显式指定该路径，避免落到默认 /tmp（可能被 systemd-tmpfiles 清理）：
```
client_body_temp_path /var/tmp/nginx/client_body 1 2;
```
Beego 的 UploadDir（保存最终文件的位置）也要确保磁盘空间够、权限可写，否则上传成功但保存失败，前端看到“200”却找不到文件