147 lines
4.3 KiB
Markdown
147 lines
4.3 KiB
Markdown
# 微信小程序部署指南
|
||
|
||
## 前置条件
|
||
|
||
- 已安装 [微信开发者工具](https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html)
|
||
- 已有微信公众平台小程序账号（AppID: `wxdbddd60e12144043`）
|
||
- 后端 API 已部署并可访问（`https://dda.gaowenbu.cn`）
|
||
|
||
---
|
||
|
||
## 一、微信公众平台配置
|
||
|
||
### 1.1 配置服务器域名
|
||
|
||
登录 [微信公众平台](https://mp.weixin.qq.com/) → 开发管理 → 开发设置 → 服务器域名
|
||
|
||
点击「修改」，添加以下域名：
|
||
|
||
| 类型 | 域名 |
|
||
|------|------|
|
||
| request 合法域名 | `https://dda.gaowenbu.cn` |
|
||
| uploadFile 合法域名 | `https://dda.gaowenbu.cn`（如需要） |
|
||
| downloadFile 合法域名 | `https://dingdan9471.oss-cn-beijing.aliyuncs.com`（OSS 域名） |
|
||
|
||
> ⚠️ **域名必须是 ICP 备案的，且必须是 https**
|
||
|
||
### 1.2 配置业务域名（如使用 webview）
|
||
|
||
如果小程序中有 `<web-view>` 组件，需要在「业务域名」中添加对应域名。
|
||
|
||
### 1.3 确认 AppID 一致性
|
||
|
||
当前配置中存在两个不同的 AppID：
|
||
|
||
| 位置 | AppID | 用途 |
|
||
|------|-------|------|
|
||
| `mini-app/project.config.json` | `wxdbddd60e12144043` | 小程序代码 |
|
||
| `backend/.env` 中 `WECHAT_APP_ID` | `wx84c571118b65630e` | 后端发订阅消息 |
|
||
|
||
**请确认：**
|
||
- 如果 `wx84c571118b65630e` 是另一个服务号/小程序（专门用来发消息），则无需修改
|
||
- 如果应该是同一个小程序，需要将 `backend/.env` 中的 `WECHAT_APP_ID` 改为 `wxdbddd60e12144043`，`WECHAT_APP_SECRET` 也要对应修改
|
||
|
||
---
|
||
|
||
## 二、上传小程序代码
|
||
|
||
### 2.1 打开微信开发者工具
|
||
|
||
1. 打开微信开发者工具
|
||
2. 选择「导入项目」
|
||
3. 项目目录选择 `frontend/mini-app/`
|
||
4. AppID 填写 `wxdbddd60e12144043`
|
||
5. 点击「导入」
|
||
|
||
### 2.2 检查配置
|
||
|
||
导入后确认：
|
||
|
||
- `config.js` 中 `apiBaseUrl` 是 `https://dda.gaowenbu.cn` ✅（已配置好）
|
||
- 开发者工具右上角「详情」→「基本信息」中 AppID 正确
|
||
|
||
### 2.3 本地调试
|
||
|
||
1. 点击「编译」或按 `Ctrl+B`
|
||
2. 在模拟器中测试登录、下单等功能
|
||
3. 确认 API 请求正常（在「网络」面板查看）
|
||
|
||
### 2.4 上传代码
|
||
|
||
1. 点击右上角「上传」按钮
|
||
2. 填写版本号，如 `1.0.0`
|
||
3. 填写项目备注，如 `首次部署`
|
||
4. 点击「上传」
|
||
|
||
---
|
||
|
||
## 三、提交审核与发布
|
||
|
||
### 3.1 提交审核
|
||
|
||
1. 登录 [微信公众平台](https://mp.weixin.qq.com/)
|
||
2. 管理 → 版本管理
|
||
3. 在「开发版本」中找到刚上传的版本
|
||
4. 点击「提交审核」
|
||
|
||
### 3.2 审核注意事项
|
||
|
||
- 确保小程序有完整的功能说明
|
||
- 如涉及用户登录，需要有隐私协议
|
||
- 如涉及订单/交易，需要有相关资质
|
||
- 审核一般 1-7 个工作日
|
||
|
||
### 3.3 发布上线
|
||
|
||
审核通过后：
|
||
|
||
1. 在「审核版本」中点击「全量发布」或「分阶段发布」
|
||
2. 发布后用户即可在微信中搜索使用
|
||
|
||
---
|
||
|
||
## 四、开发版本 vs 正式版本
|
||
|
||
在开发和调试阶段，可以在微信开发者工具中：
|
||
|
||
1. 点击右上角「详情」→「本地设置」
|
||
2. 勾选「不校验合法域名、web-view（业务域名）、TLS 版本以及 HTTPS 证书」
|
||
3. 这样可以使用 `http://127.0.0.1:8000` 进行本地调试
|
||
|
||
> ⚠️ 此选项仅在开发工具中生效，真机预览和正式版必须使用合法域名
|
||
|
||
---
|
||
|
||
## 五、真机调试
|
||
|
||
### 5.1 真机预览
|
||
|
||
1. 微信开发者工具中点击「预览」
|
||
2. 用手机微信扫码即可在真机上体验
|
||
3. 需要先在公众平台配置好服务器域名，否则请求会失败
|
||
|
||
### 5.2 真机调试
|
||
|
||
1. 点击「真机调试」
|
||
2. 可以在电脑上查看真机的 console 日志和网络请求
|
||
|
||
---
|
||
|
||
## 六、常见问题
|
||
|
||
### Q1: 真机请求失败，模拟器正常
|
||
|
||
检查公众平台「服务器域名」是否已配置 `https://dda.gaowenbu.cn`，且域名已备案。
|
||
|
||
### Q2: uploadFile 报错
|
||
|
||
检查公众平台「uploadFile 合法域名」是否配置。如果文件上传走的是 OSS 直传，需要配置 OSS 域名。
|
||
|
||
### Q3: 订阅消息发送失败
|
||
|
||
确认 `backend/.env` 中的 `WECHAT_APP_ID` 和 `WECHAT_APP_SECRET` 是否正确，以及是否在公众平台配置了订阅消息模板。
|
||
|
||
### Q4: 版本更新后用户没有生效
|
||
|
||
微信有缓存机制，发布后可能需要等待一段时间。也可以让用户删除小程序重新搜索打开。
|