多端前端H5 端
快速开始
环境要求
| 工具 | 版本 |
|---|---|
| Node.js | >= 18 |
| npm | >= 9 |
| 后端 | 已启动，地址配在 src/config.js |
安装
cd ruoyi-uniapp
npm install启动 H5
npm run dev:h5终端会打印实际访问地址（Vite 默认 5173），手机浏览器访问时把 localhost 换成电脑局域网 IP。
真机调试时，
src/config.js的baseUrl不能写localhost，否则手机访问的是手机自己。改成http://<电脑IP>:8086/，并确认防火墙放行。
生产构建
npm run build:h5产物在 dist/build/h5/，整个目录交给 Nginx 即可。
location / {
try_files $uri $uri/ /index.html;
}如果部署在子路径（例如 /h5/），需要同时改 uni-app 的 h5.router.base 和 Nginx location，否则静态资源 404。
验收
- 页面能打开，底部 tabBar 正常；
- 登录后能拿到 token；
- 商品 / 会员等页面有数据（说明
/open、/portal接口通）； - 浏览器控制台没有跨域报错。
H5 登录页（截图占位）
/images/docs/h5-login.png建议 390 × 844。
常见问题
| 现象 | 先查 |
|---|---|
| 真机白屏 | baseUrl 是否还是 localhost；手机与电脑是否同一网段 |
| 接口 404 | 对应应用是否安装（见 C 端接口与应用） |
| 静态资源 404 | 部署子路径与 h5.router.base 是否一致 |
| 登录后立即退出 | token 存储、请求头、后端会话配置 |