BootstrapAdmin是基于.NET 8的后台管理系统，需安装对应SDK、执行数据库迁移并确保静态资源与权限种子正确加载，否则将出现启动失败、样式错乱或登录后404等问题。
Bootstrap-Admin 不是单一可“直接 npm install”的库，而是一套开箱即用的后台管理系统框架（含前后端），必须按其技术栈和部署路径走，否则会卡在权限、路由或数据库连接上。
BootstrapAdmin 后端启动失败：.NET 8 运行时缺失或版本不匹配
官方最新版（如 Argo/BootstrapAdmin）基于 .NET 8，若本地未安装对应运行时，dotnet run 会报错 The SDK 'Microsoft.NET.Sdk.Web' specified could not be found 或直接退出。
- 必须安装 .NET 8.0 SDK（非仅 Runtime），从 dotnet.microsoft.com/download 下载并验证：
dotnet --version输出应为8.0.x - 项目根目录下执行
dotnet restore前，确认global.json中指定的 SDK 版本与已安装一致；否则删掉该文件让 CLI 自动选最新 - Windows 用户注意：IIS Express 有时会缓存旧配置，首次启动建议用
dotnet run --launch-profile "http"绕过
前端页面空白或样式错乱：CDN 资源被拦截或路径未适配
BootstrapAdmin 默认使用本地静态资源（wwwroot/lib/ 下的 Bootstrap、jQuery、Font Awesome），但部分部署环境（如 Nginx 反向代理）会因路径前缀或 MIME 类型导致 CSS/JS 加载失败，浏览器控制台出现 Failed to load resource: net::ERR_ABORTED。
- 检查浏览器 Network 面板中
bootstrap.min.css和site.css是否返回 404 或 403；若是，确认 Nginx 的location /块是否正确映射到wwwroot - 若改用 CDN，请替换
_Layout.cshtml中所有本地引用，例如将~/lib/bootstrap/dist/css/bootstrap.min.css改为https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/css/bootstrap.min.css，同时补上 Popper 和 jQuery CDN（Bootstrap 5 不再依赖 jQuery，但 BootstrapAdmin v6 仍用） - 禁用浏览器扩展（尤其广告/脚本拦截器），某些插件会误杀
fontawesome字体请求
登录后跳转 404 或菜单不显示：RBAC 权限数据未初始化
BootstrapAdmin 启动后不会自动创建用户或菜单，首次访问 /Account/Login 成功后，若跳转到空页面或提示 “You do not have permission to access this resource”，说明角色、菜单、权限三张核心表为空。
- 运行项目前，先执行一次数据库迁移：
dotnet ef database update（确保已安装dotnet-ef工具） - 首次启动时，系统会尝试通过种子数据（
SeedData.cs）插入默认管理员账号（admin@bootstrapadmin.com/admin123），但该逻辑只在数据库为空时触发；若手动清过表，需重新运行应用或调用dotnet run --seed（部分版本支持） - 检查
appsettings.json中ConnectionStrings:DefaultConnection是否指向可写的数据库实例；SQLite 路径如BootstrapAdmin.db必须有写权限，否则种子失败且无日志提示
真正卡住人的往往不是编译错误，而是权限种子静默失败、反向代理路径重写丢失 X-Forwarded-Proto 导致 HTTPS 重定向循环、或浏览器 localStorage 里残留了旧版菜单缓存 —— 这些问题不会报红字，只会让你对着空白页反复刷新。
