从代码到上线：小程序交付前要做的事

一个小程序从第一行代码到真正跑在用户手机上，中间隔着的不是「再改改」，而是一整套上线前的收尾工作。我是知码客，常驻邯郸做小程序和 APP 开发，这几年交付过不少本地项目，从丛台区的餐饮连锁到永年的紧固件批发商，几乎每个项目在提审前都会遇到同一类问题。这篇文章就把上线前该做的事按顺序理一遍，给准备自己动手或正在验收的开发者一个参照。

一、先确认「上线」到底指什么

很多客户口中的上线，其实包含三个不同阶段：

• 提审上线：代码提交到微信平台，审核通过后发布正式版。
• 灰度与体验版：先给内部或部分用户用体验版跑一段时间。
• 运营上线：正式版对外，同时配置好数据统计、客服、消息推送等运营能力。

这三步节奏不一样。提审只关心合规与功能可用，运营上线才决定用户第一次打开时的体验。邯郸本地不少客户是线下生意为主，小程序往往承担预约、下单、会员卡这几件事，一旦正式版出问题，影响的是门店当天流水，所以建议把体验版至少跑满一周再发布。

二、提审前必须自查的几项

1. 类目与资质

小程序的服务类目要和实际功能对得上。餐饮外卖需要食品经营相关资质，教育培训、医疗健康类目审核更严。类目选错是最常见的驳回原因，改起来还要重新排队，建议在开发初期就定下来。

2. 隐私协议与用户授权

只要涉及手机号、位置、头像昵称，就必须有隐私保护指引，并在用户首次触发时弹窗确认。微信对「未授权就静默收集」查得很严，代码里不要图省事默认获取。

3. 支付与订单链路

支付要跑通「下单—支付—回调—发货/核销—退款」完整闭环。回调地址必须是已备案的 HTTPS 域名，本地调试用的内网地址千万别带到线上。

4. 域名与服务器

request 合法域名、uploadFile 域名、downloadFile 域名、socket 域名要逐个配置，少一个就在真机上白屏。服务器如果放在国内，域名需要完成 ICP 备案，这一步周期不短，要提前安排。

三、代码层面的收尾清单

功能跑通只是及格线，上线前建议过一遍这些点：

• 把 console.log 和调试开关清理干净，避免把内部接口地址暴露出去。
• 检查分包配置，主包控制在 2MB 以内，图片资源尽量走 CDN。
• 首屏渲染做骨架屏或 loading，弱网环境下不要让用户对着白屏。
• 对关键接口加超时与失败重试，支付、下单这类操作要有明确的错误提示。
• 版本号在 app.json 或项目配置里规范管理，方便回滚时定位。

// 上线前统一收敛的请求封装示例
const request = (url, options = {}) => {
  return new Promise((resolve, reject) => {
    wx.request({
      url: BASE_URL + url,
      timeout: 8000,
      ...options,
      success: (res) => {
        if (res.statusCode >= 200 && res.statusCode < 300) {
          resolve(res.data);
        } else {
          reject(new Error('请求失败：' + res.statusCode));
        }
      },
      fail: reject
    });
  });
};

这类封装看起来琐碎，但能省掉上线后大量「偶发白屏」的排查时间。我在给邯郸本地一家连锁烘焙店做会员小程序时，就是因为统一了超时和错误提示，上线首周几乎没有收到用户反馈的卡顿问题。

四、发布之后才是真正的开始

正式版发布后，建议立刻做三件事：接入数据统计看首日打开率与留存，配置客服消息入口，准备好一版紧急回滚方案。小程序支持版本回退，但回退前要确认数据库结构没有做不兼容的变更。

另外，微信的审核时间并不固定，节假日前后可能变长。如果项目有明确的开业或活动时间点，提审至少提前三到五个工作日，别把上线日卡在活动前一天。

五、给准备做小程序的朋友

如果你在邯郸，正打算把门店、批发业务或者内部管理搬到小程序上，建议先把「谁用、用来干什么、上线后谁维护」这三件事想清楚，再谈功能和报价。知码客专注小程序与 APP 开发，做的是把需求落到能长期跑的代码上，而不是交一个演示版本就结束。上线只是起点，后面还有迭代、数据和安全要持续跟进，这部分工作往往比开发本身更影响最终效果。