> 本文整理自平台文档 docs/wujies/5.x/frontends/h5/config.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-2eef0f2ada90-cover.svg)
移动端的后端地址不在 .env 里,而在 src/config.js。改地址只看这一个文件。
config.js
const config = {
baseUrl: '<后端根地址,带协议与结尾斜杠>',
clientID: '<与后端 sys_client 记录对应的客户端标识>',
appEncrypt: false,
rsaPublicKey: '<与后端配套的 RSA 公钥>',
rsaPrivateKey: '<与后端配套的 RSA 私钥>',
}
> 仓库里这份文件目前带着开发 / 演示地址与一组仓库自带的密钥(含 RSA 私钥)。别把生产值提交进公开仓库,也别照抄仓库里的现成取值上线——公钥/私钥/clientID 都要换成你自己环境生成的。
| 字段 | 作用 | 注意 |
|---|---|---|
baseUrl | 接口根地址 | 必须带协议;真机调试不能写 localhost |
clientID | 客户端标识,随请求头 clientid 发出 | 必须对应后端 sys_client 表里 app 那行(grantType 要含你用的登录方式) |
appEncrypt | 接口加密开关 | 必须与后端同时开/关 |
rsaPublicKey | 请求加密公钥 | 更换时前后端一起换 |
rsaPrivateKey | 响应解密私钥 | 不要提交真实生产密钥到公开仓库 |
> 正式项目请改成按环境读取,至少区分 dev 与 prod,不要把生产地址写死在源码里。移动端没有 .env 约定,需要自己接 import.meta.env 或多份 config 文件。
请求封装
统一走 src/utils/request.ts:
- 自动拼
baseUrl(uni.request,默认超时 10 秒); - 有 token 时自动带上
Authorization: Bearer <token>与clientid两个请求头; - 统一处理 401(提示后重新登录)、500 与其他错误码(见
src/utils/errorCode.js); appEncrypt为真时,POST/PUT 走 AES 密钥 + RSA:请求体用 AES 加密、密钥用 RSA 公钥加密后放进encrypt-key请求头,响应按同一份头解密。
页面里不要直接 uni.request,否则 token、错误码、加密逻辑会各写一套。
> src/utils/wujies.js 只是几个日期 / 格式化小工具,没有任何文件引用它,不是请求封装,别看错。
多端差异
| 能力 | H5 | App | 小程序 |
|---|---|---|---|
| 请求 | uni.request | 同左 | 同左,但需配置合法域名 |
| 存储 | localStorage | 原生存储 | 各端存储 |
| 支付 | H5 支付 | App 支付 | 小程序支付 |
| 登录 | 账号 / 短信 / 微信 | 同左 + 一键登录 | 微信授权登录 |
条件编译:
<!-- #ifdef H5 -->
<view>H5 专属内容</view>
<!-- #endif -->
<!-- #ifdef APP-PLUS -->
<view>App 专属内容</view>
<!-- #endif -->
<!-- #ifdef MP-WEIXIN -->
<view>微信小程序专属内容</view>
<!-- #endif -->
检查清单
- [ ]
baseUrl指向正确环境,且真机可访问 - [ ]
clientID与后端一致 - [ ]
appEncrypt与后端一致 - [ ] 生产密钥没有提交到公开仓库
- [ ] 小程序端已配置 request 合法域名
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-2eef0f2ada90-guide.svg)


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