小程序发布与版本管理

适用范围

版本发布工作台只展示当前租户、app_type=1、is_component=1 的第三方平台授权小程序。普通自有小程序无法使用第三方平台代开发上传接口，应继续通过微信开发者工具发布。

标准发布闭环

1. 在第三方平台代码模板库确认普通模板可用。
2. 选择授权小程序和模板。
3. 填写版本号、版本说明并上传代码。
4. 生成体验二维码，使用真机验证接口、登录、支付和主要页面。
5. 维护体验成员，必要时绑定测试微信号。
6. 从微信实时读取已上传页面和可选类目。
7. 选择 1 至 5 个审核页面，填写页面标题和可选标签。
8. 提交审核并定期刷新状态。
9. 审核中可以撤回。
10. 审核通过后正式发布。

上传代码会覆盖当前体验版，正式发布会立即影响线上用户，两项操作都应二次确认。

模板和审核项

• 代码模板实时读取第三方平台普通模板库。
• 上传代码使用通用扩展配置，不在工作台维护个性化 ext.json 编排。
• 审核页面必须从微信返回的代码页面中选择，不能使用固定商城路径。
• 类目必须是当前小程序微信侧允许的类目。
• 本地历史记录缺失时，仍可从微信实时版本信息继续流程。

体验成员

体验成员页面支持查询、绑定和解绑。成员保存在微信侧，不落本地副本。

绑定后使用体验二维码验证。解绑会立即影响体验权限，应避免删除仍参与验收的成员。

审核加急

发布工作台可查询提审额度和申请加急审核。加急能力取决于微信账号资格、剩余额度和当前审核单状态，不保证立即完成审核。

权限：wxma:wxrelease:speedup。

分阶段发布

审核通过并发布后，可设置微信支持的灰度比例、查询当前灰度状态和撤销灰度。

灰度发布适用于降低版本风险，不替代测试：

• 先选择较小比例观察错误和性能。
• 确认稳定后扩大比例或全量。
• 出现问题可撤销灰度或使用版本回退。

权限：wxma:wxgrayrelease:index、edit、revert。

线上版本回退

回退使用微信官方线上版本回退能力。操作会影响全部线上用户，必须确认目标版本和微信当前允许回退的状态。

权限：wxma:wxrelease:rollback。

回退后还应检查：

• 配套业务服务是否支持目标版本使用的接口协议。
• 数据结构是否发生不可逆变化。
• 目标版本依赖的插件和隐私接口是否仍可用。

最低基础库版本

工作台可查询和设置最低基础库版本，用于阻止过旧微信客户端运行无法正常支持的功能。调整前应结合用户客户端分布评估影响。

权限：wxma:wxsupportversion:index、edit。

访问与搜索状态

可查询小程序访问状态，并管理搜索可见性等微信支持的状态。小程序被限制访问时，应结合违规处罚记录和微信通知排查。

权限：wxma:wxonline:index、visit、search。

发布权限拆分

建议开发人员有上传和体验权限，运营负责人有提交审核权限，正式发布和回退只授予发布负责人。

发布验收清单

• AppID、模板 ID、版本号正确。
• 体验版能登录并访问生产或预发布接口。
• 页面路径和审核类目有效。
• 隐私协议、插件、服务器域名和业务域名已配置。
• 审核状态由微信刷新取得。
• 发布后检查访问状态、实时日志、JS 错误和性能监控。