微信小程序开发从零到上架，这份避坑指南请收好

拿到微信小程序的审核通过通知，我盯着屏幕愣了好几秒。从注册账号到代码提交，整整折腾了23天。期间踩过的坑，比过去五年写Web应用加起来都多。这篇文章不聊官方文档里那些漂亮话，只说我真实摔过的跟头，给准备入坑的朋友备点止痛药。

先说注册和类目选择这关。很多人图省事，随手选个“工具”类目就提交了，结果审核被拒三次才反应过来——你的小程序如果涉及内容发布，必须有“社交-社区”类目资质，而这个类目需要《增值电信业务经营许可证》。我见过最惨的案例，有个做二手交易的哥们儿，开发完才发现自己需要《拍卖经营批准证书》，整个项目直接作废。注册前先去微信公众平台的“类目介绍”页面，把每个类目的资质要求截图保存，对着你的产品功能一条条核对，比什么攻略都管用。

然后说开发环境。微信开发者工具刚打开时，那个模拟器会让你产生错觉——以为在写普通网页。等真机调试那天，你会被各种兼容性问题砸懵。比如iPhone的底部安全区，安卓机的键盘弹起遮挡，还有不同机型对CSS grid的支持差异。我的经验是，从第一天起就养成习惯：每写完一个功能，立刻用“预览”功能扫码在真机上跑一遍。别偷懒，模拟器里看着完美的布局，真机上可能错位到妈都不认识。

说到接口调用，这里有个特别容易忽略的坑。小程序的request域名必须是在后台配置过的HTTPS地址，而且IP地址不行，必须是备案过的域名。我第一次测试时直接填了本地IP，调试了半小时才反应过来。更坑的是，你本地调试用的域名和线上正式环境必须分开配置，否则上线后用户请求会全部失败。建议在开发初期就把测试域名和正式域名都配好，省得后面手忙脚乱。

接着讲数据缓存。小程序本地缓存有10MB上限，听起来不小，但如果你存图片base64编码，几张图就满了。我在这个坑里栽得最惨——用户反馈图片加载慢，排查半天发现是缓存满了，每次都要重新请求网络。正确做法是，图片和视频单独存到云存储或CDN，本地缓存只放用户配置、登录状态这类轻量数据。还有一点，缓存数据要加版本号，否则你更新逻辑后，用户手机里还是旧版本的数据，排查起来能疯掉。

版本审核这关，我总结了几条血泪教训。第一，千万不要在周五下午提交审核。微信审核团队周六日效率极低，我上次周五提交，硬是等到下周二才有结果。第二，审核不通过的理由往往很模糊，比如“页面内容涉及未授权信息”。这时候别急着改代码，先看看是不是你的隐私协议没写清楚，或者用户协议里的措辞有法律风险。第三，如果你的小程序有用户生成内容（UGC），必须设置内容安全接口，否则审核必拒。这个接口申请需要一定流程，提前两周着手。

上线前有个步骤特别容易漏——体验版测试。很多人开发完直接提交审核，结果用户一打开就白屏。因为你没在“成员管理”里添加体验成员，或者体验版二维码过期了。建议正式提交前，拉五个不同手机型号的朋友帮你扫码测试，覆盖iOS和安卓高低端机型。我那次上线后才发现，华为Mate60上底部Tab栏被手势条挡住，只能紧急发版本修复，用户体验大打折扣。

说说支付功能的坑。微信支付接入比想象中复杂，需要申请商户号，还要配置支付证书。最让人崩溃的是，支付回调的验签算法文档写得含糊，我照着示例代码写了好几版才通过。如果你做的是虚拟商品，比如会员、课程，还得提前申请“虚拟支付”权限，这个审核更严格，需要提供软件著作权证书。建议把支付功能放在整个项目开发的第一优先级，因为它的审核周期最长，往往是你所有功能里最后才能用的。

回看这23天，最大的感悟是：小程序开发不是写代码，是跟一堆规则和流程周旋。你写的每一行代码，都要经过审核团队、真机环境、用户习惯这三重考验。避坑指南写得再多，都不如你亲自摔一次记得牢。但至少，这些经验能让你少走些弯路。毕竟，小程序这条路，走通的人都知道，前面坑虽多，风景也确实好。