location ^~ /static/ 是最高优先级前缀匹配，必须配 alias（非 root）、禁用 Beego 静态路由、加缓存头，三者缺一不可。
Beego 默认把 static、views、conf 三个目录和二进制文件放一起，但生产环境常需将静态资源（如 CSS/JS/图片）交由 Nginx 或 CDN 托管，避免 Go 进程处理大量 I/O。这不单是性能问题，更是权限隔离和缓存策略的刚需。
为什么不能只靠 SetStaticPath 就完事
很多人在 main.go 里写 web.SetStaticPath("/static", "./static")，开发时能跑通，但上线后会出问题：
- Nginx 若未配置对应 location 块，请求
/static/css/app.css会直接 404，而不是 fallback 到 Beego 处理 -
./static是相对路径，打包后二进制运行位置一变，路径就失效；SetStaticPath无法动态读取环境变量或配置项 - Beego 的
http.ServeFile不支持 ETag、Last-Modified 等标准缓存头，Nginx 能原生支持并自动压缩（gzip/brotli） - 若用
beego.StaticDir显式注册，它仍走 Go HTTP Handler，没绕过进程，起不到卸载压力作用
Nginx 配置静态资源路径的关键点
假设你把静态文件统一放在 /data/www/static，Beego 服务监听 127.0.0.1:8080，Nginx 做反向代理。核心不是“怎么配”，而是“哪些必须配”：
- 用
location ^~ /static/而非location /static/：避免被正则 location 覆盖，保证优先匹配 - 必须加
alias /data/www/static/;（注意末尾斜杠），不是root—— 否则路径会拼成/data/www/static/static/xxx - 显式关闭 Beego 的静态路由：在
conf/app.conf中设EnableStatic = false，防止冲突 - 加缓存头：
expires 1y;和add_header Cache-Control "public, immutable";，让浏览器长期缓存带哈希的文件
location ^~ /static/ {
alias /data/www/static/;
expires 1y;
add_header Cache-Control "public, immutable";
}
部署时如何确保路径不混乱
Beego 项目编译后是单个二进制，但 static、views、conf 必须按约定结构存在。常见翻车点：
-
conf/app.conf里的appname、httpport等可留默认，但runmode = prod必须显式设置，否则beego.BConfig.WebConfig.StaticExtensions可能不生效 -
views目录仍需随二进制部署，因为模板渲染是 Go 进程内行为，没法交给 Nginx - 如果用了
beego.LoadAppConfig("ini", "conf/app.conf")，确保启动前工作目录是二进制所在路径，或改用绝对路径加载：beego.LoadAppConfig("ini", "/opt/app/conf/app.conf") - 别把
static目录复制到二进制同级再用SetStaticPath—— 这等于白做分离，Go 还是得读文件
真正分离的标志，是访问 /static/xxx.js 时，响应头里没有 X-Powered-By: beego，且 Nginx access log 显示该请求没打到 upstream。路径、权限、缓存头，三者缺一不可。
