微信小程序
微信小程序用于把租户站点发布为微信小程序，并在租户后台完成授权、基础配置、体验版、审核、发布和版本管理。这个页面直接影响用户能否通过微信小程序访问企业站点、登录、支付和使用业务功能。
微信小程序用于把租户站点发布为微信小程序，并在租户后台完成授权、基础配置、体验版、审核、发布和版本管理。这个页面直接影响用户能否通过微信小程序访问企业站点、登录、支付和使用业务功能。
你可以在这里做什么
| 目标 | 操作入口 | 影响范围 |
|---|---|---|
| 绑定小程序 | 立即授权 / AppID 配置 | 建立租户站点与微信小程序的关系 |
| 配置小程序登录 | AppID、AppSecret | 用户在小程序内微信登录 |
| 配置支付方式 | 小程序支付方式 | 小程序内订单、会员、算力购买 |
| 同步隐私指引 | 用户隐私保护指引 | 微信审核、合规提示 |
| 同步服务器域名 | 服务器域名配置 | 小程序请求接口、上传下载、WebView |
| 部署体验版 | 一键部署代码 / 源码包下载 | 生成可测试版本 |
| 提交微信审核 | 提交审核 | 进入微信官方审核流程 |
| 发布线上版本 | 发布全网 | 覆盖小程序线上版本 |
| 管理体验者 | 体验者管理 | 指定谁可以扫码预览体验版 |
| 版本回退 | 版本回退 | 回退到上一个线上版本 |
一、先理解小程序发布链路
小程序不是保存配置后立即上线，它有一条完整链路：
| 阶段 | 目标 | 完成标志 |
|---|---|---|
| 授权或绑定 | 平台拿到小程序管理权限 | 后台显示已授权，能读取小程序信息 |
| 基础配置 | 登录、隐私、域名、支付可用 | AppSecret、隐私指引、服务器域名配置完成 |
| 部署体验版 | 上传平台小程序模板 | 可以获取体验版二维码 |
| 内部测试 | 体验者扫码验证核心流程 | 登录、支付、内容访问正常 |
| 提交审核 | 送微信官方审核 | 状态变为审核中 |
| 发布全网 | 审核通过后正式上线 | 页面显示已发布和发布时间 |
如果是独立部署模式，页面会提供源码包下载，管理员需要自行到微信小程序后台上传、提审和发布。
二、授权小程序
- 进入「微信小程序」。
- 未授权时，先填写小程序 AppID 和 AppSecret。
- 点击立即授权。
- 按微信授权页提示扫码确认。
- 授权成功后回到租户后台，确认小程序名称、主体、头像等信息已回显。
授权成功后，系统会尝试自动同步隐私指引和服务器域名。如果自动同步失败，不代表授权失败，需要到基础配置里单独处理失败项。
三、配置小程序登录
小程序登录依赖 AppID 和 AppSecret。AppSecret 保存后不会明文回显，页面只显示是否已配置。
操作步骤：
- 打开「基础配置」。
- 确认 AppID 正确。
- 填写或更新 AppSecret。
- 保存密钥。
- 到体验版中测试微信登录。
如果 AppSecret 错误，用户可能无法完成微信授权登录，表现为登录失败、无法获取 openid 或会话异常。
四、配置小程序支付方式
| 支付方式 | 适合场景 | 配置重点 |
|---|---|---|
| 微信支付 | 真实商品、会员、算力充值 | 需要在支付设置中完成微信商户号配置 |
| 虚拟支付 | 小程序虚拟商品交易场景 | 需要配置虚拟支付 OfferID、OfferKey、消息推送参数 |
| 关闭支付 | 暂不在线收款 | 用户点击支付时引导联系客户服务 |
选择微信支付时，不要只保存小程序页面的支付方式，还需要检查「支付设置」里微信支付是否可用。选择虚拟支付时，需要到微信小程序后台获取虚拟支付参数，并将页面生成的回调地址配置到微信后台。
五、配置隐私指引
微信小程序审核会检查隐私保护指引。页面内已预置常用且必要的隐私权限，通常只需要填写开发者联系邮箱并同步。
操作步骤：
- 打开「基础配置」中的「用户隐私保护指引」。
- 填写开发者联系邮箱。
- 保持默认隐私权限启用，除非明确知道某项能力不再使用。
- 保存配置。
- 点击同步隐私指引到微信后台。
- 确认同步状态为成功。
可以参考：
不建议随意删减默认权限。权限缺失可能导致审核驳回，也可能导致用户端弹窗说明与实际能力不一致。
六、同步服务器域名
服务器域名决定小程序能访问哪些接口、上传下载哪些文件，以及 WebView 能打开哪些业务页面。页面按微信要求分为 request、socket、uploadFile、downloadFile 和 WebView 域名。
操作步骤：
- 打开「服务器域名配置」。
- 检查官方必备域名是否已自动带出。
- 按业务需要补充自定义域名。
- 点击同步域名配置。
- 等待微信后台返回结果。
- 如果 WebView 域名未完全生效，按提示检查校验文件或微信后台配置。
可以参考：
微信后台对域名修改次数有限制，通常不要为了测试频繁同步。域名要尽量一次确认完整后再提交。
七、部署体验版并内部测试
- 在「部署管理」中确认基础配置已完成。
- 点击一键部署代码。
- 部署成功后点击获取体验版。
- 将需要测试的微信号添加为体验者。
- 体验者扫码进入体验版。
- 验证首页、登录、关键业务流程、支付、文件访问和 WebView 页面。
审核前一定要先内部测试。尤其是模板更新后，要确认用户端页面没有出现本地演示模式、接口未连接、登录失败或图片资源无法访问。
八、提交审核和发布全网
- 体验版确认无误后，点击提交审核。
- 等待微信官方审核。
- 审核通过后，点击发布全网。
- 发布完成后，用普通微信用户身份打开线上小程序做一次复测。
审核中不能重新部署同一版本。若审核被驳回，应根据驳回原因修改站点内容或配置，然后重新部署并再次提交审核。
九、版本回退和解除授权
版本回退用于线上版本出现严重问题时，尝试回退到上一个线上版本。回退前要确认当前线上问题确实影响用户，不要把它当作普通撤回操作。
解除授权分两步：
- 在本平台解除授权，清除租户后台保存的授权信息。
- 到微信小程序后台的第三方设置中，手动解除对本平台的授权。
只在本平台解除授权，不会完全解除微信侧授权关系。
十、注意事项
- 小程序配置会影响真实线上用户，发布前必须经过体验版测试。
- AppSecret、虚拟支付密钥、消息推送 Token 都是敏感信息，只允许可信管理员维护。
- 微信支付需要同时检查支付设置、小程序关联商户号、微信后台产品权限。
- 服务器域名修改次数有限，不要频繁同步测试。
- WebView 域名通常需要校验文件，域名未校验时即使同步也可能不完整。
- 审核驳回后不要直接反复提交，应先修正驳回原因。
十一、常见问题
授权成功后还需要填 AppSecret 吗？
需要。授权用于管理小程序版本和配置，AppSecret 用于小程序端微信登录，两者解决的问题不同。
为什么体验版二维码扫不了？
确认扫码微信号已添加为体验者。仍不可用时，重新获取体验版二维码，并检查体验版是否部署成功。
审核通过后用户为什么还看不到新版？
审核通过只是可以发布，不等于已经上线。需要点击发布全网后，普通用户才能访问新版本。
选择关闭支付会怎样？
小程序内支付能力不会直接收款，用户触发支付时会按系统逻辑引导联系客户服务。
立即构建您的专属 AI 智能体与自动化矩阵
井云 Studio 为您提供多租户底座、工作流编排、资产分发与计费闭环，助您快速上线高质量 AI SaaS 产品。
