vue-admin-better 常见问题快速排查指南从依赖安装到路由权限【免费下载链接】vue-admin-better vue admin,vue3 admin,vue3.0 admin,vue后台管理,vue-admin,vue3.0-admin,admin,vue-admin,vue-element-admin,ant-design,vab admin pro,vab admin plus,vue admin plus,vue admin pro项目地址: https://gitcode.com/GitHub_Trending/vu/vue-admin-bettervue-admin-better 是一套基于 Vue 2.7 Element UI 的后台管理框架内置 RBAC 权限模型、JWT 登录态和 mock 数据MIT 协议可免费商用。刚 clone 下来跑不通时坑基本集中在三个阶段装依赖、本地启动、登录与路由权限。这篇针对 vue-admin-better 常见问题的排查文把坑点做成了速查表——先对症状再翻到对应小节动手。项目速览30 秒技术栈Vue 2.7、Element UI、Vuex、Vue RouterRspack 构建启动命令npm run serve:rspack默认端口 8090配置入口src/config/下的setting.config.js、theme.config.js、net.config.js三个文件没有 .env 文件mock 数据全部在mock/目录接口默认指向/vab-mock-server卡点速查表你看到的现象大概率卡在哪去哪修pnpm i卡住或直接报错网络源或仓库里缺本地依赖包依赖装不上 一节启动后 8090 端口打不开命令写错、端口占用、Node 版本启动失败 一节登录成功又立刻弹回登录页token 没写入、接口成功码对不上弹回登录页 一节登录后菜单空白或进 401 / 404权限数据为空、authentication模式选错路由权限 一节⚙️ 依赖装不上先查这 3 件事git clone https://gitcode.com/GitHub_Trending/vu/vue-admin-better pnpm i --registryhttp://mirrors.cloud.tencent.com/npm/注意两点用 pnpm 而不是 npm。仓库里带的是pnpm-lock.yaml混用包管理器容易装出不一致的依赖树。package.json里有两个本地依赖file:layouts和file:vab-icon它们不在 npm 源上而是仓库里的子目录。如果 clone 不完整比如浅克隆、少拉了目录安装会直接报ENOENT或file:找不到——这种情况删掉重装也没用补全仓库再装。 网络不稳时换成--registryhttps://registry.npmmirror.com装完仍异常可用npm run clear清空node_modules重装。 启动失败 / 8090 打不开按顺序排确认命令。本项目的开发启动脚本是serve:rspack不是servenpm run serve:rspack看端口。开发端口在src/config/setting.config.js的devPort默认8090。被别的程序占了就改这里或者杀掉占端口的进程。看 Node 版本。package.json虽然写着node 8.9但 Rspack 2.x 这条构建链在 Node 16 上才稳版本太低先升级再谈其他。看报错而不是看白屏。终端里第一处红色报错常见的是 sass 相关、依赖版本冲突才是真因浏览器现象只是结果。锁步安装兜底npm run clear会清掉node_modules并用 npmmirror 源重装一遍。 登录成功又弹回登录页路由拦截在拦你登录态的判定逻辑写在src/config/permission.js流程是有 token → 调接口拉权限 → 注册动态路由 → 放行。任何一环断了router.beforeResolve都会把你踢回/login。按下表自查配置项位置默认值什么时候要改baseURLsrc/config/net.config.js/vab-mock-server接自己的后端时successCode同上[200, 0]后端成功码不是 200 / 0 时invalidCode同上402登录失效码对不上时tokenNamesrc/config/setting.config.jsaccessToken换了 token 字段名时最常见的两个具体原因后端或 mock返回的成功码不在successCode里axios 封装会把成功响应当失败处理token 根本不会写入。打开浏览器 Application 面板看 localStorage 里 key 为vue-admin-better-2024的条目存不存在一眼分辨接口坏了还是判定坏了。接了真后端但成功码体系不同只改successCode一个字段通常就够了接口地址、成功码、失效码三处都要和后端对一遍。 登录后菜单空白或 401 / 404路由权限没对齐权限模式由src/config/setting.config.js的authentication控制两个取值intelligence默认后端只下发权限码前端按权限码渲染菜单和路由all路由完全由后端下发前端只负责加载。对号入座直接进 401net.config.js里noPermissionCode是401说明当前用户的权限数组里压根没有这个页面的权限码。先看 mock 侧的数据源mock/controller/user.jspermissions是否为空接真后端时看接口返回。进 404权限有、但路由没注册成功。all模式下完全依赖后端返回的路由结构字段名、层级和src/store/modules/routes.js里期望的结构对不上就会这样。菜单空白但页面能点多数是权限请求发出去了但响应被上面的成功码判定拦下回到上一节查。把上面四处过一遍vue-admin-better 本地跑不起来的大部分情况都能定位到具体文件。后续改动配置都从 src/config/ 入手联调 mock 行为看 mock/完整说明见 README.md。【免费下载链接】vue-admin-better vue admin,vue3 admin,vue3.0 admin,vue后台管理,vue-admin,vue3.0-admin,admin,vue-admin,vue-element-admin,ant-design,vab admin pro,vab admin plus,vue admin plus,vue admin pro项目地址: https://gitcode.com/GitHub_Trending/vu/vue-admin-better创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 vue-admin-better 常见问题快速排查指南：从依赖安装到路由权限
vue-admin-better 常见问题快速排查指南从依赖安装到路由权限【免费下载链接】vue-admin-better vue admin,vue3 admin,vue3.0 admin,vue后台管理,vue-admin,vue3.0-admin,admin,vue-admin,vue-element-admin,ant-design,vab admin pro,vab admin plus,vue admin plus,vue admin pro项目地址: https://gitcode.com/GitHub_Trending/vu/vue-admin-bettervue-admin-better 是一套基于 Vue 2.7 Element UI 的后台管理框架内置 RBAC 权限模型、JWT 登录态和 mock 数据MIT 协议可免费商用。刚 clone 下来跑不通时坑基本集中在三个阶段装依赖、本地启动、登录与路由权限。这篇针对 vue-admin-better 常见问题的排查文把坑点做成了速查表——先对症状再翻到对应小节动手。项目速览30 秒技术栈Vue 2.7、Element UI、Vuex、Vue RouterRspack 构建启动命令npm run serve:rspack默认端口 8090配置入口src/config/下的setting.config.js、theme.config.js、net.config.js三个文件没有 .env 文件mock 数据全部在mock/目录接口默认指向/vab-mock-server卡点速查表你看到的现象大概率卡在哪去哪修pnpm i卡住或直接报错网络源或仓库里缺本地依赖包依赖装不上 一节启动后 8090 端口打不开命令写错、端口占用、Node 版本启动失败 一节登录成功又立刻弹回登录页token 没写入、接口成功码对不上弹回登录页 一节登录后菜单空白或进 401 / 404权限数据为空、authentication模式选错路由权限 一节⚙️ 依赖装不上先查这 3 件事git clone https://gitcode.com/GitHub_Trending/vu/vue-admin-better pnpm i --registryhttp://mirrors.cloud.tencent.com/npm/注意两点用 pnpm 而不是 npm。仓库里带的是pnpm-lock.yaml混用包管理器容易装出不一致的依赖树。package.json里有两个本地依赖file:layouts和file:vab-icon它们不在 npm 源上而是仓库里的子目录。如果 clone 不完整比如浅克隆、少拉了目录安装会直接报ENOENT或file:找不到——这种情况删掉重装也没用补全仓库再装。 网络不稳时换成--registryhttps://registry.npmmirror.com装完仍异常可用npm run clear清空node_modules重装。 启动失败 / 8090 打不开按顺序排确认命令。本项目的开发启动脚本是serve:rspack不是servenpm run serve:rspack看端口。开发端口在src/config/setting.config.js的devPort默认8090。被别的程序占了就改这里或者杀掉占端口的进程。看 Node 版本。package.json虽然写着node 8.9但 Rspack 2.x 这条构建链在 Node 16 上才稳版本太低先升级再谈其他。看报错而不是看白屏。终端里第一处红色报错常见的是 sass 相关、依赖版本冲突才是真因浏览器现象只是结果。锁步安装兜底npm run clear会清掉node_modules并用 npmmirror 源重装一遍。 登录成功又弹回登录页路由拦截在拦你登录态的判定逻辑写在src/config/permission.js流程是有 token → 调接口拉权限 → 注册动态路由 → 放行。任何一环断了router.beforeResolve都会把你踢回/login。按下表自查配置项位置默认值什么时候要改baseURLsrc/config/net.config.js/vab-mock-server接自己的后端时successCode同上[200, 0]后端成功码不是 200 / 0 时invalidCode同上402登录失效码对不上时tokenNamesrc/config/setting.config.jsaccessToken换了 token 字段名时最常见的两个具体原因后端或 mock返回的成功码不在successCode里axios 封装会把成功响应当失败处理token 根本不会写入。打开浏览器 Application 面板看 localStorage 里 key 为vue-admin-better-2024的条目存不存在一眼分辨接口坏了还是判定坏了。接了真后端但成功码体系不同只改successCode一个字段通常就够了接口地址、成功码、失效码三处都要和后端对一遍。 登录后菜单空白或 401 / 404路由权限没对齐权限模式由src/config/setting.config.js的authentication控制两个取值intelligence默认后端只下发权限码前端按权限码渲染菜单和路由all路由完全由后端下发前端只负责加载。对号入座直接进 401net.config.js里noPermissionCode是401说明当前用户的权限数组里压根没有这个页面的权限码。先看 mock 侧的数据源mock/controller/user.jspermissions是否为空接真后端时看接口返回。进 404权限有、但路由没注册成功。all模式下完全依赖后端返回的路由结构字段名、层级和src/store/modules/routes.js里期望的结构对不上就会这样。菜单空白但页面能点多数是权限请求发出去了但响应被上面的成功码判定拦下回到上一节查。把上面四处过一遍vue-admin-better 本地跑不起来的大部分情况都能定位到具体文件。后续改动配置都从 src/config/ 入手联调 mock 行为看 mock/完整说明见 README.md。【免费下载链接】vue-admin-better vue admin,vue3 admin,vue3.0 admin,vue后台管理,vue-admin,vue3.0-admin,admin,vue-admin,vue-element-admin,ant-design,vab admin pro,vab admin plus,vue admin plus,vue admin pro项目地址: https://gitcode.com/GitHub_Trending/vu/vue-admin-better创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考