郑州小程序上线前，我踩过的部署坑

上周帮一位在郑州做社区团购的客户处理上线问题，代码本地跑得好好的，一到真机就白屏。折腾到晚上十一点，发现是云开发环境没切到正式版。这种事我遇到过太多次了，今天就把小程序从开发到部署这一路容易翻车的地方捋一遍，尤其是郑州本地做实体生意的朋友，看完能少走点弯路。

一、开发阶段就得想清楚部署方式

很多人写代码时随手点了个「云开发」，等到要上线才发现域名、备案、服务器一样没准备。小程序部署大致两条路：

• 自建服务器：需要 HTTPS 域名、ICP 备案、配置合法域名。郑州这边的客户如果服务器放在本地机房或者阿里云郑州节点，备案走河南通管局，一般七到十五个工作日，别等到要提交审核了才想起来。
• 云开发：省掉域名和服务器，适合快速验证。但要注意环境 ID 别搞混，测试环境和生产环境一定要分开，否则测试数据会混进正式库。

我一般建议客户先明确业务量级。日订单几百单的小程序，云开发完全够用；要是做本地商城、要对接自有 ERP，那还是老老实实自建后端。

二、部署前必须检查的几件事

1. 合法域名配置

登录微信公众平台，在「开发管理 - 开发设置」里把 request、uploadFile、downloadFile、socket 的域名都配上。常见坑是只配了 request，结果上传图片失败。域名必须备案且是 HTTPS，二级域名也要单独配。

2. 环境变量与配置分离

把接口地址、appid、密钥这些抽到配置文件里，别写死在业务代码中。我见过一个郑州做餐饮外卖的客户，测试环境的支付参数直接打包进了正式版，上线当天支付全挂。用 config.js 按环境导出是最简单的做法：

// config.js
const env = __wxConfig.envVersion; // develop / trial / release
const configs = {
  develop: { api: 'https://dev.api.com' },
  trial:   { api: 'https://test.api.com' },
  release: { api: 'https://api.com' }
};
export default configs[env] || configs.develop;

3. 分包与体积控制

主包超过 2MB 就传不上去。图片尽量放 CDN，不常用的页面做成分包。本地生活类小程序经常堆一堆活动页，提前规划分包能省很多事。

三、上传、审核与发布

开发者工具点「上传」，填版本号和备注，然后到公众平台提交审核。这里有几个实战经验：

• 审核前把测试账号准备好，写在审核备注里，尤其是需要登录才能看的页面。
• 类目要和实际业务一致。郑州做家政、做教育咨询的客户，类目选错会被打回，来回就是两三天。
• 首次提审建议选在工作日上午，审核相对快一些。
• 审核通过后记得点「发布」，很多人以为审核过了就上线了，结果用户根本搜不到。

上线不是终点。发布后第一时间用真机走一遍核心流程，支付、登录、下单，一个都别漏。

四、上线后的监控与迭代

小程序后台的「运维中心」能看到错误日志和性能数据。建议接入实时日志，线上一出问题能快速定位。另外版本回退要提前演练，真出事的时候不至于手忙脚乱。

我在郑州做小程序和 APP 开发这些年，接触的本地客户多是餐饮、零售、社区服务这类实体生意。他们的共同点是预算有限、要得快，所以部署方案我一般往「轻」里做：能用云开发就不上服务器，能复用就不重写。知码客这边接的不少项目，从需求到上线控制在四到六周，靠的就是把部署流程标准化，少踩坑就是省成本。

如果你也在郑州，正准备把手里的小程序推上线，不妨先把上面这几条对一遍。部署这事不难，难的是细节，细节顺了，上线那天才能睡个安稳觉。