小程序发布前，我踩过的五个坑

做小程序这几年，代码写完只是开始。真正让人半夜睡不着的，是点下「提交审核」之后的那几个小时。今天不聊框架选型，也不聊性能优化，就说说发布环节那些实打实的坑，都是我或者身边同行亲身踩过的。

坑一：类目选错，审核直接打回

很多人第一次提交，随手选个「工具」类目就交上去了。结果审核员一看，你这明明有交易功能，属于电商平台，驳回理由写得客客气气，但就是不告诉你该选哪个。

我的经验是：先看功能，再看资质。有支付就走电商或生活服务，有内容发布就考虑社交或资讯。类目选错一次，重新提交又要排队，少则半天多则两三天。更麻烦的是有些类目需要前置审批，比如医疗、教育，没资质根本过不了，这个在动手写代码前就该确认。

坑二：测试账号没给，审核员进不去

这个坑特别冤。小程序有登录逻辑，审核员打开一看是登录页，没有账号，直接驳回「无法体验完整功能」。

解决办法很简单，在提交审核的「补充说明」里写清楚测试账号和密码，最好再配一段操作路径说明。我现在的习惯是专门准备一个测试账号，数据是干净的，权限是完整的，密码写在备注里。别嫌麻烦，这一步能省掉一轮往返。

补充说明示例：
测试账号：test_user
密码：Test@123456
操作路径：登录后进入首页 → 点击「我的」→ 查看订单列表
说明：该账号已预置三条测试订单数据

坑三：隐私协议和用户信息授权

现在微信对用户隐私这块查得很严。只要你的小程序收集了手机号、位置、头像昵称，就必须配置隐私保护指引，并且在用户首次触发相关功能时弹出授权。

我见过不少项目，功能都做完了，发布时才发现隐私协议没配，代码里还在用旧的 getUserInfo 接口。这里提醒一句：头像昵称的获取方式早就变了，得用 button open-type="chooseAvatar" 配合 input type="nickname"。老代码不改，审核大概率过不了，就算过了，后面也可能被用户投诉。

坑四：体验版能跑，正式版白屏

这个问题最折磨人。开发的时候一直用体验版，接口地址写的是测试环境，提交正式版忘了切。用户一打开，白屏。

我的做法是把环境配置抽出来，用构建变量区分，发布前跑一遍检查清单：

• 接口域名是否已在小程序后台配置为合法域名，且是 https
• 是否切换到了生产环境配置
• 是否有残留的 console.log 和调试开关
• 版本号和更新说明是否填写

别小看最后一条，版本号乱填，后面想回滚都找不到对应版本。

坑五：发布不等于结束，灰度很重要

很多人以为审核通过、点发布就万事大吉。其实微信支持分阶段发布，先放 10% 或者指定用户，观察一两天再全量。这个功能真的救命。

我有一次全量发布后，发现某个安卓机型上支付回调异常，幸亏发现得早，紧急回滚。从那以后，凡是涉及支付的版本，我一律先灰度。回滚也简单，后台点一下「版本回退」，几分钟就能恢复到上一版。

发布流程本身不复杂，复杂的是细节。把检查清单固定下来，每次照着过一遍，比凭记忆靠谱得多。

最后说两句

小程序发布这件事，技术含量不高，但特别考验细心程度。类目、测试账号、隐私协议、环境配置、灰度发布，这五件事理顺了，基本就不会卡在审核上。剩下的就是耐心等，顺便祈祷审核员心情好。

如果你也在准备发布，不妨把上面几条当成发布前的 checklist 过一遍。少踩一个坑，就少熬一个夜。