小程序灰度发布与版本管理

本地开发 → 真机预览（开发版）
    ↓ 上传代码并填写版本号
体验版（体验成员验证核心流程）
    ↓ 提交审核
微信审核（内容与类目合规检查）
    ↓ 审核通过
灰度发布（按比例 1% → 10% → 50% → 100%）
    ↓ 每个阶段观察监控与用户反馈
全网发布

// app.js 中监听小程序版本更新
const updateManager = wx.getUpdateManager();

updateManager.onUpdateReady(() => {
  wx.showModal({
    title: '更新提示',
    content: '新版本已经准备好，是否重启应用？',
    success(res) {
      if (res.confirm) {
        updateManager.applyUpdate();
      }
    }
  });
});

updateManager.onUpdateFailed(() => {
  // 新版本下载失败，提示用户主动清除缓存
  console.warn('版本更新失败');
});

{
  "feature": {
    "new_checkout": {
      "enabled": true,
      "gray_ratio": 0.2,
      "min_wechat_version": "3.0.0"
    },
    "new_home_layout": {
      "enabled": false
    }
  }
}

// 拉取远程开关后决定渲染哪个版本的页面
function getFeatureConfig() {
  return wx.getStorageSync('feature_config') || defaultConfig;
}

Page({
  data: {
    useNewCheckout: false
  },
  onLoad() {
    const config = getFeatureConfig();
    const ratio = config.feature.new_checkout.gray_ratio;
    // 用 openid 做稳定哈希，保证同一用户始终看到同一版本
    const bucket = hashCode(openid) % 100;
    this.setData({
      useNewCheckout: bucket < ratio * 100
    });
  }
});

版本号规范：主版本.次版本.修订版本
  1.2.0   主功能迭代（可能影响既有交互）
  1.2.1   缺陷修复（兼容旧逻辑）
  2.0.0   重大重构（可能不兼容旧版本）

// build-info.js 由 CI 构建时自动生成
module.exports = {
  version: '1.2.1',
  buildNo: '20260930-001',
  commitSha: 'a3f2c9e',
  branch: 'release/1.2.1'
};

构建流程：git tag 打版本 → CI 触发构建 → 生成 build-info.js
        → 上传体验版 → 审核 → 灰度 → 全网

// 一致性分桶：基于 openid 的稳定灰度
function bucketOf(openid, totalBuckets = 1000) {
  let hash = 0;
  for (let i = 0; i < openid.length; i++) {
    hash = ((hash << 5) - hash + openid.charCodeAt(i)) | 0;
  }
  return ((hash % totalBuckets) + totalBuckets) % totalBuckets;
}

// 1% 灰度即 bucket < 10
function inGray(openid, grayPercent) {
  return bucketOf(openid) < grayPercent * 10;
}

// 上报灰度实验分组信息
function reportGrayGroup(group) {
  wx.request({
    url: 'https://api.example.com/track/gray',
    method: 'POST',
    data: {
      openid: getOpenid(),
      group,            // 'experiment' 或 'control'
      version: '1.2.1',
      page: currentPage()
    }
  });
}

回退步骤：
1. 微信后台「版本管理」选择上一线上版本，点击回退
2. 客户端侧拉取远程开关，关闭问题功能
3. 服务端做好新旧协议兼容（灰度期间新旧版本并存）
4. 记录回退原因，补充回归用例

// 服务端响应：新字段 optional，不影响旧端解析
{
  "code": 0,
  "data": {
    "order_id": "20260930001",
    "status": "PAID",
    "estimated_delivery": "2026-10-02"   // 新增字段，旧端忽略
  }
}