Admin后台默认不启用，必须在beego.Run()前显式调用beego.AddAdmin注册并手动设置BConfig.WebConfig.AdminUser/AdminPass，同时确保static/admin/静态资源完整存在，否则将出现404或白屏。
Admin 后台默认不启用，必须显式注册
Beego 的 Admin 模块是独立组件，不会随框架自动加载。即使项目结构里有 conf/app.conf 或引入了相关包，beego.Admin 也不会生效——除非你在 main.go 中调用 beego.AddAdmin 或 beego.BConfig.WebConfig.Admin 显式开启。
常见错误现象：访问 /admin 返回 404，或页面空白但无报错；日志里完全不出现 Admin 相关初始化信息。
- 必须在
beego.Run()之前注册，顺序错误会导致注册失败 - 推荐写法：
beego.AddAdmin(&admin.AdminController{}, "/admin") - 如果使用自定义路由前缀（如
/manage），第二个参数要同步改，否则静态资源路径会 404 - Admin 不依赖数据库，但若配置了
beego.BConfig.WebConfig.AdminUser和AdminPass，登录才生效；否则默认无认证
配置账号密码需在 Run 前设置 BConfig
Admin 后台的登录校验由 Beego 内部完成，不走控制器逻辑。账号密码不是从 app.conf 自动读取的，必须手动赋值给 beego.BConfig.WebConfig.AdminUser 和 beego.BConfig.WebConfig.AdminPass。
容易踩的坑：在 app.conf 里写 adminuser=xxx 没用；或者把赋值语句写在 beego.Run() 之后，导致配置被忽略。
- 正确位置示例：
beego.BConfig.WebConfig.AdminUser = "super_admin" beego.BConfig.WebConfig.AdminPass = "super_admin" beego.Run()
- 密码明文存储，生产环境务必通过环境变量注入，不要硬编码
- 若未设置，Admin 页面仍可访问，但所有接口返回 401，且登录框不显示
静态资源路径冲突导致 CSS/JS 加载失败
Admin 后台自带前端资源（CSS、JS、图标），全部托管在 /static/admin/ 下。如果你的项目已存在 static/ 目录，并且你手动覆盖或清空过它，Admin 就无法加载样式，表现为纯文字白屏或按钮失效。
这不是权限或路由问题，而是文件缺失。Beego 不会自动创建这些文件，也不提供一键安装命令。
- 解决方法：从 Beego 源码仓库的
admin子目录（如github.com/beego/beego/v2/server/web/admin）复制static/admin/到你项目的static/目录下 - 注意路径层级：
static/admin/css/、static/admin/js/必须完整存在 - 如果用了自定义
StaticDir配置（如beego.SetStaticPath("/assets", "assets")），Admin 资源也得映射过去，否则 404
Admin 与 beego-admin 第三方后台不可混用
官方 beego.Admin 是轻量监控面板（查看路由、内存、goroutine 数等），而 beego-admin（如 gitee.com/EricZsp/beego-admin）是完整 RBAC 后台系统，二者定位完全不同，代码无兼容性。
试图同时启用两者，会出现路由冲突（比如都注册 /admin）、模板渲染错乱、静态资源覆盖等问题，且没有任何文档支持这种组合。
- 监控用途选原生
beego.Admin；业务管理后台选beego-admin或其他方案 -
beego-admin需要手动导入 SQL、配置数据库、运行go mod tidy，和官方 Admin 完全无关 - 别在同一个项目里 import
github.com/beego/beego/v2/server/web/admin和github.com/yuxingfei/beego-admin—— 编译可能通过，但运行时 panic 风险高
真正麻烦的从来不是开启 Admin，而是它不报错地“假装工作”：页面能打开、登录框能显示、甚至还能输密码——但点进去全是空数据或 404。根源往往在静态路径或配置时机，而不是功能开关本身。
