Beego静态资源需显式注册路径映射，否则404且无提示；必须在beego.Run()前调用SetStaticPath绑定URL前缀与本地目录，如beego.SetStaticPath("/static", "static")；多个映射按注册顺序匹配，末尾不加斜杠；默认不支持目录索引或自动补index.html，需手动启用DirectoryIndex或自写BeforeRouter；私有资源须用beego.BeforeStatic过滤器，不可依赖BeforeRouter；StaticDir为启动时读取的全局map，运行时修改无效。
Beego 静态资源不是靠“自动发现”，必须显式注册路径映射，否则 404 不报错、也不提示缺配置。
用 SetStaticPath 注册静态目录映射
Beego 不会默认扫描 static 目录，哪怕你真建了这个文件夹。必须在 beego.Run() 之前调用 SetStaticPath 手动绑定 URL 前缀和本地目录：
beego.SetStaticPath("/static", "static")
beego.SetStaticPath("/js", "assets/js")
beego.SetStaticPath("/uploads", "./data/uploads")
注意点：
-
"/static"是用户访问的 URL 路径前缀，比如请求/static/css/app.css -
"static"是相对于当前可执行文件所在目录的本地路径（不是相对于main.go） - 多个
SetStaticPath可共存，Beego 按注册顺序匹配，遇到第一个匹配前缀就停止 - 路径末尾不加斜杠，
SetStaticPath("/static/", "static")会导致匹配失败
为什么访问 /static/ 返回 404 而不是目录页或 index.html
Beego 默认不处理目录索引，http.ServeFile 对目录请求会直接返回 404（不跳转、不补 index.html）。要启用目录页或自动补 index.html，得手动开关：
立即学习“go语言免费学习笔记（深入）”；
- 显示目录列表：
beego.DirectoryIndex = true（慎用，生产环境暴露文件结构） - 自动补
index.html：beego.DirectoryIndex = true同时确保目标目录下存在index.html；Beego 不会像 Nginx 那样对/foo/自动试/foo/index.html，它只对明确请求/foo/且DirectoryIndex=true时才列出内容 - 若想实现「请求
/admin/返回admin/index.html」，必须自己写BeforeRouter过滤器拦截并重写路径，不能依赖SetStaticPath
私有静态资源（如登录后才能看的 PDF）不能用 BeforeRouter
很多人误以为在 BeforeRouter 里写个路径判断就能拦住 /static/private/xxx.pdf，但 Beego 的静态文件处理逻辑绕过了常规路由链 —— 它在 BeforeRouter 之后、Controller 之前就完成了响应，所以你的过滤器根本不会触发。
正确做法是用 beego.BeforeStatic：
beego.InsertFilter("/static/private/*", beego.BeforeStatic, controllers.CheckAuth)
关键细节：
-
BeforeStatic是唯一能介入静态文件服务前的钩子，文档虽少但稳定可用 - 过滤器函数里不能直接用
ctx.Input.Session()，需手动启动 Session：sess, _ := beego.GlobalSessions.SessionStart(ctx.ResponseWriter, ctx.Request) - 匹配模式中的
*必须保留，否则子路径（如/static/private/report/v2.pdf）不会被捕获
StaticDir 是全局 map，别在运行时动态改
beego.SetStaticPath 内部只是往全局变量 StaticDir（类型为 map[string]string）里塞键值对。这个 map 在 Beego 初始化阶段被读取一次，后续修改不会生效。
也就是说，下面这段代码无效：
beego.SetStaticPath("/static", "static")
// … 后续某处又想换路径
beego.SetStaticPath("/static", "public") // ← 不会覆盖，旧映射仍生效
如果需要多套环境不同静态路径（如开发 vs 生产），应在启动前通过配置或 flag 决定，而不是运行中切换。
最易被忽略的一点：所有静态路径注册必须发生在 beego.Run() 之前，且不能在 goroutine 里异步调用 —— 否则可能因竞态导致部分映射丢失或 panic。
