北京小程序上线前，我踩过的那些坑

上周帮一位做社区生鲜的客户把小程序送审通过，从提交到正式发布花了四天，中间被驳回两次。客户在朝阳，团队不大，第一次做小程序，问我最多的一句话是：代码都写完了，为什么还不能上线？

这个问题挺典型。在北京做小程序开发这几年，我发现很多团队把「发布」当成点一下按钮的事，实际上它是一整套流程：资质、类目、审核、版本管理、灰度、回滚，哪一环没准备好，都可能卡在最后一步。这篇就聊聊我踩过的坑，给准备上线的朋友提个醒。

一、资质和类目，别等到提交才想起来

微信小程序的类目选择直接决定审核尺度。比如做食品销售，需要《食品经营许可证》；做在线问诊，需要《互联网医疗保健信息服务审核同意书》。北京这边很多客户是传统企业转型，营业执照没问题，但专项资质往往没有提前办。

我一般会在开发启动阶段就列一张清单，让客户同步准备：

• 主体资质：营业执照、法人身份证，个体户和企业要求不同；
• 服务类目：按实际业务选，别贪多，选错类目会被要求补充材料；
• 特殊行业：食品、医疗、教育、金融、直播，各有各的门槛；
• 支付相关：开通微信支付需要单独签约，对公账户信息要核对清楚。

有个做少儿编程的客户，在海淀，小程序里带了课程售卖，类目选了「教育」，审核要求补充办学许可。后来把售卖部分挪到 H5，小程序只做课程展示和预约，才顺利过审。这不是钻空子，而是产品形态和资质要匹配。

二、体验版测完，再谈提交审核

很多人本地跑通就提交，结果审核员看到的是白屏。原因通常是域名没配、接口没开 HTTPS、或者体验版和正式版环境不一致。

我的习惯是提交前走一遍「体验版清单」：

1. 在微信开发者工具里上传代码，设为体验版，用真机扫码走完整流程；
2. 检查所有 request 域名是否已在后台配置，且证书有效；
3. 确认没有引用未上线的云开发环境或测试数据库；
4. 把手机号、定位、相册等授权弹窗的文案过一遍，别出现「获取用户信息用于营销」这种表述；
5. 准备一个测试账号，审核员需要登录时能直接进。

这一步花不了多少时间，但能省掉一轮驳回。审核一次通常一到三天，来回两次就是一周，对赶节点的项目影响不小。

三、版本发布不是终点，灰度才是

小程序后台支持分阶段发布，我一般会先放 10% 的量观察一天。看什么？看错误日志、看接口成功率、看用户反馈。北京本地客户里做餐饮和零售的比较多，周末流量高峰明显，如果周五晚上全量发布，出问题就是整晚的事故。

// 发布前在关键路径埋点，方便灰度期定位问题
wx.reportAnalytics('order_submit', {
  from: 'cart',
  amount: order.total,
  ts: Date.now()
});

// 接口失败时给出可恢复的提示，而不是一句“网络错误”
try {
  const res = await request('/api/order', params);
} catch (e) {
  wx.showToast({ title: '提交失败，请稍后重试', icon: 'none' });
  wx.reportAnalytics('order_fail', { code: e.code });
}

灰度期间如果发现严重问题，后台可以回退到上一个线上版本，这个能力一定要提前确认可用。别等出事才翻文档。

四、发布之后，才是运营的开始

小程序上线只是拿到入场券。我见过不少客户，发布完就放着，三个月后打开后台，访问量还是个位数。发布后至少要跟进三件事：

• 数据埋点：页面停留、转化漏斗、分享路径，先有数才能谈优化；
• 版本节奏：小步快跑，两周一个迭代，比憋大招靠谱；
• 用户反馈入口：小程序内的客服消息要有人回，差评和 bug 往往从这里来。

知码客一直说「知码识途、匠心铸客」，落到发布这件事上，就是把流程做扎实，把细节想到前面。代码写得好不好，用户未必看得见；但上线顺不顺、用起来稳不稳，他们一打开就知道。

如果你也在北京做小程序，正卡在发布环节，欢迎聊聊。资质清单、审核驳回原因、灰度策略，这些坑我都趟过，能帮你少走点弯路。