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