邯郸小程序上线前，我踩过的部署坑

上周帮邯郸丛台区一个做社区团购的客户处理上线问题，代码本地跑得好好的，传到体验版就白屏。折腾到晚上十一点，发现是云开发环境 ID 配错了。这种事在小程序部署阶段太常见了，今天把我和团队在邯郸做小程序开发时踩过的部署坑整理一下，希望能帮到正在准备上线的朋友。

一、部署不是点一下上传那么简单

很多刚开始接触小程序的朋友以为，微信开发者工具点「上传」就完事了。实际上从代码写完到用户能搜到你的小程序，中间隔着好几个环节：

• 域名备案与服务器配置（邯郸本地客户用国内服务器的，备案周期要提前算进去）
• 小程序后台的服务器域名白名单配置
• 业务域名、request 合法域名、uploadFile 域名分开配
• 隐私协议与用户信息授权接口的合规调整
• 提交审核、版本发布、灰度观察

任何一环漏了，用户端就是各种报错。知码客在给邯郸本地客户做交付时，一般会把这些整理成一张上线检查清单，逐项打勾，比凭记忆靠谱得多。

二、云开发还是自建服务器

这是邯郸做小程序的朋友问得最多的问题。我的建议是看场景：

适合云开发的情况

• 预算有限、想快速上线验证想法的小程序
• 团队里没有专职运维
• 业务量不大，比如本地餐饮点单、社区服务预约

适合自建服务器的情况

• 已有成熟后端系统，小程序只是多一个入口
• 对数据存储位置、审计有要求的企业客户
• 并发量大、需要精细控制成本的场景

云开发的好处是省心，但要注意环境隔离。我习惯给每个项目建两个环境：一个开发环境，一个生产环境。上线前把生产环境 ID 写进配置，别像开头那位客户一样，体验版连的还是测试库。

// config.js 里区分环境
const ENV = {
  dev: 'cloud-dev-xxxxx',
  prod: 'cloud-prod-xxxxx'
}

export const currentEnv = ENV.prod

三、审核被拒的几个高频原因

邯郸本地客户做的小程序，审核被拒主要集中在几类：

1. 类目选错。卖食品的选了「工具」，肯定过不了，要选对应的电商或食品类目，该办的资质提前准备。
2. 收集用户信息没有说明用途。授权弹窗的文案要写清楚为什么收集手机号，隐私协议要能打开。
3. 页面存在诱导分享。「转发到三个群解锁」这种文案现在基本秒拒。
4. 测试账号没给。有登录功能的小程序，审核备注里要给测试账号密码，不然审核员进不去。

这些坑不涉及技术难度，但每次被拒都要重新排队，少则一天多则三五天。提前对照检查一遍，能省不少时间。

四、上线后的第一周别松懈

版本发布不等于结束。我的习惯是上线后盯三天数据：

• 看错误监控，有没有集中的 JS 报错
• 看接口成功率，尤其是支付回调
• 看首屏加载时间，图片该压缩的压缩，能上 CDN 的上 CDN
• 留意用户反馈入口，本地客户往往直接微信找你，问题反馈比后台快

之前给邯郸永年一个做紧固件生意的客户上线报价查询小程序，上线第二天就收到反馈说部分安卓机打开慢。查下来是首屏一次性加载了太多产品图，后来改成懒加载加缩略图，体验就顺了。这种问题不上线根本发现不了。

五、给邯郸本地开发者的几句实在话

小程序部署这件事，技术门槛不算高，难在细节和耐心。在邯郸做小程序开发，客户大多是本地实体商家和中小企业，他们不太关心你用了什么框架，只关心打开快不快、下单顺不顺、出了问题找不找得到人。所以部署阶段多花半天做检查，比上线后半夜被电话叫醒划算得多。

我是知码客，专注小程序和 APP 开发，用代码改变生活。如果你也在邯郸，正准备把自己的小程序推上线，上面这些清单可以拿去对照着过一遍。有拿不准的地方，欢迎交流。