中国 帮助

环境与接口配置

移动端的后端地址不在 .env 里,而在 src/config.js。改地址只看这一个文件。 config.js js const config = { baseUrl: '<后端根地址,带协议与结尾斜杠', client

环境与接口配置
封面

> 本文整理自平台文档 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 只是几个日期 / 格式化小工具,没有任何文件引用它,不是请求封装,别看错。

多端差异

能力H5App小程序
请求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)

章节导览
THE END

喜欢就支持以下吧

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

回到内容