石家庄小程序上线前，我踩过的5个坑

上周帮一位石家庄桥西区的客户把小程序送审，第三次才过。客户是做社区生鲜的，之前找过一家外地团队，代码交付后拖了两个月上不了线，最后找到我们知码客收拾残局。这种事在本地不算少见，今天就把上线环节最容易翻车的几个点摊开说说，都是真金白银换来的经验。

一、类目选错，审核直接卡死

很多人以为小程序提交审核就是点个按钮，其实类目才是第一道门槛。石家庄不少做本地生活服务的客户，比如家政、维修、社区团购，很容易把类目选成「电商平台」或者「生活服务」，结果被要求补充资质。生鲜类目要食品经营许可证，家政要相关备案，选错了就是反复驳回。

我的建议是：先看营业执照经营范围，再对照微信的类目表逐条核对，不确定的宁可选窄不选宽。宽类目看着省事，审核时反而要你证明「你确实做这个」。

二、服务器域名没备案，请求全挂

这是最冤的一种。代码本地跑得好好的，一上线接口全 404。原因往往是小程序后台配置的 request 合法域名没做 ICP 备案，或者备案主体和账号主体对不上。

// 上线前自检清单（后端侧）
1. 域名已完成 ICP 备案，且主体一致
2. 已配置 request / uploadFile / downloadFile 合法域名
3. 域名证书有效，HTTPS 强制开启
4. 后端接口在公网可访问，无内网 IP 写死
5. 数据库连接池、跨域、白名单已放开生产环境

石家庄本地有些客户图便宜买了香港服务器，备案是省了，但微信要求合法域名必须是备案域名，这条路走不通。老老实实用国内云主机，走完备案流程，反而最快。

三、隐私协议和用户授权没跟上新规

现在小程序对用户隐私保护查得很严。获取手机号、位置、相册，都要在隐私协议里写清楚用途，并且要在代码里做「用户拒绝授权后的降级处理」。我见过一个石家庄做教育培训的客户，登录页直接弹手机号授权，用户点拒绝就白屏，审核员一测就驳回。

正确做法是先让用户浏览，需要手机号时再弹，拒绝后给个「暂不登录，先逛逛」的出口。这不仅是过审问题，也直接影响转化。

四、支付和订单流程没走通就提交

审核员是真的会下单的。支付没配商户号、回调地址写的是测试环境、订单状态机缺分支，这些都会在审核环节暴露。特别是微信支付，商户号绑定、API 密钥、证书这三样缺一不可，很多团队交付时只给了代码，没给配置说明，客户自己根本接不上。

知码客交付项目时有个习惯：上线前拉一遍完整链路，从注册、下单、支付到退款，每个状态都截图留档。石家庄本地客户大多没有专职技术，这份文档比代码本身还重要。

五、版本发布和体验版混淆

最后一个坑比较低级但高频：开发版、体验版、正式版搞混。有人把体验版二维码发给用户，有人提交审核后忘了点「发布」，还有人改了代码没重新上传就以为生效了。上线前把版本号、提交记录、发布状态对一遍，能省掉大量「怎么还是旧页面」的扯皮。

小程序上线不是终点，是第一次真正面对用户。上线后的埋点、错误监控、版本回滚预案，最好在提交审核前就准备好。

写在最后

在石家庄做小程序开发这几年，我越来越觉得，上线这件事考验的不是写代码多花哨，而是对流程细节的敬畏。一个类目、一条域名、一份隐私协议，任何一处疏忽都可能让项目卡上半个月。知码客的信念是「知码识途、匠心铸客」，代码是跟用户沟通的语言，而上线，是把这句话真正说出口的那一刻。如果你正卡在审核环节，不妨对照上面几条先自查一遍，多数问题其实在提交前就能解决。