SetStaticPath必须在web.Run()前调用，推荐置于main()开头或init()函数中；支持多次调用注册多路径，路径参数为二进制所在目录的相对或绝对路径，不支持~或环境变量。
Beego 中 SetStaticPath 的正确调用时机和位置
必须在 web.Run() 之前完成静态路径注册，否则映射不会生效。常见错误是把 SetStaticPath 写在控制器初始化之后、或放在某个路由处理函数里——这时框架已启动 HTTP 监听，配置被完全忽略。
典型安全位置只有两个：main() 函数开头，或 init() 函数中（需确保 init() 在 web.Run() 前执行）。
-
web.SetStaticPath("/static", "./static")：将 URL 路径/static/xxx.css映射到磁盘上./static/xxx.css - 路径参数支持相对路径（如
./assets）和绝对路径（如/var/www/myapp/static），但不支持以~或环境变量开头的路径 - 一个 Beego 应用可多次调用
SetStaticPath，注册多个前缀，比如同时配/images和/js
StaticDir 映射后文件访问失败的三个常见原因
配置写对了，但浏览器访问 /static/style.css 返回 404，大概率不是代码问题，而是路径解析逻辑没理清。
- URL 路径必须严格匹配前缀，
SetStaticPath("/static", "./static")后，/staticfoo/main.js不会命中——因为strings.HasPrefix(path, "/static")判定失败 - 磁盘路径末尾不加斜杠，
./static/和./static效果一致；但若写成./static/，而实际文件在./static/css/app.css，那请求/static/css/app.css才能成功，/css/app.css不行 - Go 进程当前工作目录影响相对路径解析：如果用
go run main.go启动，工作目录是main.go所在目录；如果用./myapp启动，工作目录是执行命令时的 shell 当前路径——务必用os.Getwd()打印确认
需要自动补 index.html？别依赖 Beego 默认行为
Beego 的 StaticDir 处理逻辑里没有自动查找 index.html 的机制。请求 /static/ 或 /public/ 这类结尾带斜杠的路径时，它不会追加 index.html 再去查文件，直接返回 404。
立即学习“go语言免费学习笔记（深入）”；
如果你确实需要目录索引能力（比如把 /docs/ 当成文档根），得自己写过滤器：
func TransparentStatic(ctx *context.Context) {
path := ctx.Request.URL.Path
if strings.HasPrefix(path, "/api/") || strings.HasPrefix(path, "/v1/") {
return
}
file := "static" + path
if strings.HasSuffix(path, "/") {
file += "index.html"
}
if _, err := os.Stat(file); os.IsNotExist(err) {
ctx.Abort()
return
}
http.ServeFile(ctx.ResponseWriter, ctx.Request, file)
}
beego.InsertFilter("/*", beego.BeforeRouter, TransparentStatic)
注意：这里必须手动加 os.Stat 检查，否则 http.ServeFile 遇到不存在的文件会 panic 并返回 500，而不是预期的 404。
生产环境绕过 Beego 静态服务，直接用 Nginx
Beego 的静态文件服务本质是 Go 协程逐个读文件再写 Response，吞吐量和并发能力远不如 Nginx。上线前应移除所有 SetStaticPath，改由反向代理接管：
- Nginx 配置示例：
location /static { alias /path/to/your/static/; } - 确保
alias末尾有斜杠，且磁盘路径真实存在并具有读权限 - Beego 应用本身不再暴露任何静态路径，避免重复配置和权限混淆
- 开发阶段用 Beego 自带服务没问题，但一旦涉及 gzip、缓存头（
Cache-Control）、ETag、HTTP/2 支持等，Nginx 是唯一靠谱选择
最容易被忽略的一点：很多人以为“Beego 配好了，静态资源就稳了”，其实它只适合开发验证；真实压测下，静态请求会迅速吃光 Goroutine 和文件描述符，而这点在本地跑几个页面完全看不出来。
