> 本文整理自平台文档 docs/wujies/5.x/frontends/h5/quickstart.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-6edaf1d5fe43-cover.svg)
环境要求
| 工具 | 版本 |
|---|---|
| Node.js | >= 18 |
| npm | >= 9 |
| 后端 | 已启动,地址配在 src/config.js |
安装
cd wujies-uniapp
npm install
启动 H5
npm run dev:h5
终端会打印实际访问地址——本仓库 vite.config.js 里写死了 server.port: '3002'(不是 Vite 默认的 5173),手机浏览器访问时把 localhost 换成电脑局域网 IP。
> 真机调试时,src/config.js 的 baseUrl 不能写 localhost,否则手机访问的是手机自己。改成开发机的局域网地址(形如 http://<电脑IP>:8086/),并确认防火墙放行。
> vite.config.js 里那条 /dev-api 代理指向 http://localhost:8080,对本工程不起作用:移动端所有请求都走 config.js 的绝对 baseUrl,不经过 dev server。改端口、改后端地址请改 src/config.js,别改这里。
生产构建
npm run build:h5
产物在 dist/build/h5/,整个目录交给 Nginx 即可。
location / {
try_files $uri $uri/ /index.html;
}
如果部署在子路径(例如 /h5/),需要同时改 uni-app 的 h5.router.base 和 Nginx location,否则静态资源 404。
验收
1. 页面能打开,底部 tabBar 正常; 2. 登录后能拿到 token; 3. 商品 / 会员等页面有数据(说明 /open、/portal 接口通); 4. 浏览器控制台没有跨域报错。
src="/images/docs/h5-login.png" caption="H5 登录页(截图占位)" hint="建议 390 × 844。" aspect="9 / 19.5" />
常见问题
| 现象 | 先查 |
|---|---|
| 真机白屏 | baseUrl 是否还是 localhost;手机与电脑是否同一网段 |
| 接口 404 | 对应应用是否安装(见 [C 端接口与应用](/docs/wujies/5.x/frontends/pc/open-api)) |
| 静态资源 404 | 部署子路径与 h5.router.base 是否一致 |
| 登录后立即退出 | token 存储、请求头、后端会话配置 |
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-6edaf1d5fe43-guide.svg)


评论区需要浏览器启用 JavaScript 才能加载。