昨天吭哧吭哧折腾公众号开发，差点被几个破问题整崩溃。掏出小本本记了七条血泪教训，你们以后可别踩坑了。
一、服务器配置死活过不去
刚搭好环境就卡在第一步，微信那边一直提示“token验证失败”。我叼着面包反复核对URL和token，连大小写都检查三遍，就是过不了。发现是服务器防火墙把微信的请求给拦了，气得我当场把防火墙规则戳了个洞才通。
二、消息神秘消失事件
测试菜单点击事件时，用户发来的消息居然离奇失踪！抓包抓到头秃，才发现公众号后台的“基本配置”里有个消息加密开关。之前手贱开了加密但代码里没处理，微信服务器发来的消息全变成火星文，程序直接傻眼。
补救方案：- 翻出一年前的开发文档比对加密流程
- 把解密的代码块硬塞进处理逻辑
- 边骂边重启了二十多次服务
三、分享链接变哑巴
精心设计的分享功能，到同事手机上变成白板一块！原来微信必须用他们家的JS-SDK才能调分享接口。我拿着公众号秘钥在调试工具里拼命刷新，结果一直报“invalid signature”。发现是：
- 网页URL里的#号锚点没去掉
- 分享时间戳超过有效期
- 参数排序规则看岔了文档
改完直接抽了半包烟压惊。
四、模板消息玩变脸
订单提醒模板昨天还好好发着，今早突然全变“服务故障”。跑去后台一看傻眼——微信把模板消息规则改成必须用户互动48小时内才能发。上个月刚写的催付功能直接报废，连夜改成用客服消息兜底。
五、支付回调神出鬼没
用户付款后业务状态死活不更新。蹲在服务器日志前守株待兔两小时，发现微信支付回调根本没过来！查完文档拍大腿：
- 回调地址必须带80或443端口
- 服务器TLS版本要1.2以上
- 还得在商户平台手动配置白名单
改完用curl模拟了三十次请求才放心。
六、二维码扫出404
给推广活动做的带参二维码，用户扫完全跳失效页面。原来生成二维码的scene_id在后台配置过最大只能32位，而我塞了36位的订单号。把用户ID和订单号拼成压缩字符串，解码时再拆开才搞定。
七、菜单刷新比蜗牛慢
改完菜单点了发布，在手机端疯狂下拉刷新半小时没变化。打电话问客服才知道：
- 微信CDN缓存最长24小时
- 安卓比IOS延迟更严重
- 测试号根本不会缓存才觉得快
现在每次发菜单都提前三天灰度发布。
搞完这七个坑瘫在椅子上算账：原本预估三天的工作量硬生生拖成两周，光调试接口就喝了十二罐红牛。建议你们动手前直接把我这条当避坑指南贴显示器上，能省下不少植发钱。
