微信小程序配置与发布
本文面向应用管理员，说明如何在越想云商中完成微信小程序的首次发布、审核上线和后续版本发布。
先了解两类版本
系统中有两类容易混淆的版本：
| 名称 | 含义 | 谁负责维护 |
|---|---|---|
| 平台可发布版本 | 越想云商已经测试并开放的客户端源码版本，包含版本号、源码和更新说明 | 平台管理员 |
| 租户发布版本 | 当前应用基于某个平台版本和本应用配置生成的一次小程序交付 | 应用管理员 |
应用管理员不需要填写版本号、源码 SHA 或构建参数。创建发布版本时，系统会自动使用当前最新可用的平台版本，并记录本次应用配置进行构建；排队期间的配置修改不会改变已创建的交付。
完整流程
微信审核通过后，还需要执行“确认上线”。审核通过不代表已经面向用户正式发布。
发布前准备
1. 确认平台已开通
进入 发布 → 微信小程序。如果页面显示“微信小程序尚未开通，请联系平台管理员”，需要由平台管理员在应用能力配置中开通微信小程序后再操作。
页面显示“平台尚未开放可发布版本”时，表示平台管理员还没有开放可用的客户端版本。此时不能自行创建版本，请联系平台管理员。
2. 完成小程序接入
在 发布 → 微信小程序 的“发布前准备”区域，点击“小程序接入”。
先填写接入信息：
- 微信小程序 AppID；
- 微信小程序 AppSecret；
- 后台展示二维码（仅用于越想云商后台展示）；
- ICP 备案号和公安备案号（如适用）。
AppID 和 AppSecret 必须属于同一个微信小程序。AppSecret 属于敏感信息，不要粘贴到聊天、截图或公开文档中。
此页面只保存越想云商运行和发布所需的配置，不会同步修改微信公众平台的小程序名称、头像、简介、类目或官方二维码。需要修改这些官方资料时，请登录微信公众平台；返回后，提交审核前检查会自动核验名称、简介、头像和类目。
确认 AppID 正确后，点击“保存并前往微信授权”，系统会保存接入信息并跳转微信页面，无需先执行一次单独保存。在微信页面完成授权后，接入页会显示“已授权”。已授权后修改接入资料，点击“保存修改”即可；需要更新授权权限时，在授权状态区域点击“重新授权”。重新授权中途取消或发生异常，现有有效授权不会因此失效。
如果已授权的小程序需要更换 AppID，点击“更换小程序”，填写新的 AppID 后点击“前往微信授权并更换”。新授权成功前，当前小程序仍保持可用；更换成功后需要重新配置新小程序的 AppSecret。存在进行中的交付时，系统会阻止更换，应先完成或按页面允许的方式放弃该交付。
3. 检查并补齐服务器域名
在 发布 → 微信小程序 的“发布前准备”区域，点击“服务器域名”。系统会列出以下域名类型的当前状态：
request合法域名；socket合法域名；uploadFile合法域名；downloadFile合法域名。
存在缺失项时，点击“补齐缺失域名”。系统只添加平台运行所需的缺失域名，不覆盖微信已有配置。
微信对域名修改有次数限制。补齐失败时，先检查微信第三方平台的服务器域名、域名备案和权限配置，再重试；不要连续重复点击。
4. 配置隐私保护指引
在 发布 → 微信小程序 的“发布前准备”区域，点击“隐私保护指引”。系统会根据小程序实际功能生成用途草稿，并结合微信已有配置和代码检测结果核对内容；首次尚未上传代码时也可以准备指引。
应用管理员主要需要补充收集方的联系邮箱或联系电话，核对信息类型和用途后勾选确认，再点击“确认并写入微信”。
隐私指引可以在上传代码前配置，不需要为此单独上传代码；提交审核前系统还会再次检查隐私相关条件。修改开发版指引不会立即改变线上版本，通常需要重新审核并正式上线后生效。
首次发布
1. 查看发布准备状态
进入 发布 → 微信小程序，先查看“发布前准备”区域。完成“小程序接入”、服务器域名和隐私保护指引后，再查看“版本发布”区域：
- 当前线上版本：微信侧当前正式线上版本；
- 平台可用版本：平台管理员开放给租户使用的最新版本；
- 本次发布：本应用正在处理的发布版本及其状态。
如果当前交付仍在构建、上传、审核或上线核验中，请先处理当前交付，不要重复创建新版本。
2. 创建发布版本
页面显示创建入口时，核对或填写本次发布说明，然后点击“创建发布版本”。发布说明会默认带入平台版本的更新说明，可以按本应用实际情况补充或修改。
以下内容由系统自动确定，不需要手动填写：
- 发布版本号；
- 源码 SHA；
- GitHub Actions 参数；
- 构建和上传任务。
创建后系统会自动开始构建和上传。只显示创建入口，通常表示当前没有需要处理的交付且已经满足创建条件。
3. 等待构建并上传
“本次发布”会依次显示“准备中”“构建中”“上传中”等状态。构建和上传通常需要几分钟，排队或编译较慢时可能更久。
此阶段可以离开页面，稍后返回点击“刷新状态”。页面中的“本次交付已进行”只表示当前交付已经持续的时间，不是预计剩余时间。
请注意：
- 不要重复创建发布版本；
- 不要因为页面暂时没有变化就反复点击；
- 构建或上传明确失败后，不要从任务中心重复执行旧构建任务，应按页面提示重新创建新的交付；
- 如果提示“结果待核对”，不要创建新版本，请联系平台管理员核对构建和微信侧状态。
上传成功后，页面会生成“体验版二维码”。
4. 扫码体验
使用微信扫描“体验版二维码”，验证登录、首页、商品、下单、支付和其他本次发布涉及的核心流程。
体验版验证通过后，再进入提交审核。发现代码问题时，不要提交审核；如果问题需要修改客户端源码，应由平台管理员准备并开放新的平台版本，再放弃尚未提审的交付，创建新交付重新构建。
5. 提交微信审核
在本次发布中点击“提交审核”。弹窗打开时只加载微信已配置类目，不会自动执行检查。可以先点击“开始检查”，查看基础资料、隐私保护指引、服务器域名、代码隐私检测和体验版的待处理事项；尚未填写资料时也允许检查。按页面提示完成：
- 选择微信公众平台中已经配置并审核通过的类目；
- 核对版本说明；
- 选择类目或修改版本说明后，旧结果会清空，再次点击“开始检查”；已有结果时按钮显示“重新检查”；
- 所有检查通过后，点击“确认提交审核”。
检查未通过时，按检查项中的提示处理：微信尚未配置基础资料或审核通过的类目时，点击“打开微信公众平台”；已加载类目但尚未选择时，在弹窗内选择即可。隐私保护指引或服务器域名缺失时，点击该检查项的“前往配置”。处理完成后返回弹窗重新检查；不要跳过检查，也不需要手动勾选“已完成”。
提交成功后，页面会显示微信审核单号，状态进入“审核中”。
6. 获取审核结果
微信审核结果通常会通过微信平台通知回传。审核期间可以返回页面，点击“刷新状态”；也可以在当前交付中点击“查询审核状态”主动核对。
审核结果有以下几种常见情况：
| 结果 | 下一步 |
|---|---|
| 审核中 | 等待审核，可稍后刷新或主动查询 |
| 审核通过 | 点击“确认上线” |
| 审核未通过 | 查看失败原因，处理问题后点击“重新提审” |
| 审核已撤回 | 根据需要重新提交审核 |
审核未通过但代码不需要变更时，通常不需要重新构建，可以直接修改审核资料或处理配置后重新提审。若需要修改客户端源码，先点击“放弃交付”，再使用平台最新开放的版本创建新交付重新构建。已撤回审核的交付也可放弃；审核仍在进行中时，应先撤回审核，确认已撤回后再放弃。放弃交付会保留审核原因与截图，不会下架当前线上小程序。
7. 确认正式上线
审核通过后，在当前交付中点击“确认上线”。这是影响线上用户的操作，请先确认体验版验证通过。
正式发布阶段可能暂时显示“发布中”“上线结果待确认”或“线上版本待核验”。此时不要重复点击“确认上线”，也不要创建新的发布版本；点击“查询上线结果”核对微信侧状态。微信明确拒绝时，本次发布会显示具体原因，处理后按页面提供的操作继续。
正式上线成功后，当前交付会进入发布历史，微信小程序线上版本也会更新。
发布新版本
什么时候需要创建新版本
出现以下任一情况时，可以进入 发布 → 微信小程序 创建新的交付：
- 平台管理员开放了新的平台可发布版本；
- 当前应用的构建配置发生了变化，需要重新生成小程序代码；
- 页面提示可以创建新交付。
系统会自动比较当前线上版本、平台可用版本和当前应用配置。平台版本和配置都没有变化时，页面会显示“已是最新”，不需要重复发布同一份代码。
同一个平台版本在应用配置发生变化后，仍可能需要为当前应用重新构建；这不代表平台版本重复开放。
发布新版本的操作
- 确认上一次交付已经正式上线、已放弃或已明确失败；
- 确认“平台可用版本”是希望发布的版本；
- 填写或确认发布说明；
- 点击“创建发布版本”；
- 按首次发布的“构建上传 → 扫码体验 → 提交审核 → 确认上线”流程完成。
如果页面提示线上状态待核对，先点击“刷新状态”；本次发布正在核验上线结果时，点击“查询上线结果”。仍无法确认时联系平台管理员核对原因，不要重复创建交付。放弃交付不会下架微信线上小程序。
常见状态说明
| 页面状态 | 含义 | 用户操作 |
|---|---|---|
| 准备中 | 已创建交付，等待构建开始 | 等待并刷新，不要重复创建 |
| 构建中 | 正在排队或编译小程序 | 等待并刷新，不要重复创建 |
| 上传中 | 构建完成，正在上传微信 | 等待并刷新，不要重复上传 |
| 体验版已就绪 | 代码已上传，体验码可用 | 扫码体验后提交审核 |
| 审核中 | 微信正在审核 | 等待或查询审核状态 |
| 审核通过 | 微信已通过审核 | 确认正式上线 |
| 发布中／上线结果待确认／线上版本待核验 | 正式发布或线上结果仍在核验 | 查询上线结果，不要重复发布 |
| 结果待核对 | 系统未能确认外部平台最终结果 | 联系平台管理员核对，不要重复操作 |
| 审核未通过 | 微信返回了审核原因 | 查看原因及截图；处理后重提，需要修改代码时放弃交付后重新构建 |
发布检查清单
首次发布或发布新版本前，确认：
- [ ] 微信小程序能力已开通；
- [ ] 已完成小程序接入：AppID、AppSecret 已配置并已完成第三方平台授权；
- [ ] 服务器域名检查通过；
- [ ] 隐私保护指引已配置并核对；
- [ ] 页面显示平台可用版本；
- [ ] 当前没有正在处理的交付；
- [ ] 体验版已经完成核心业务流程验证；
- [ ] 提交审核前检查全部通过；
- [ ] 正式上线前已确认审核结果和体验效果。