货发了用户说没通知，Tigshop开源商城基本是订阅消息模板字段八成填错了

客服备忘录里那句我还留着：后台已发货，用户小程序没动静，天天问发了没。订阅消息模板后台能配，发货出口也挂了发送。十有八九不是「没接」，是模板字段名和代码里传的不一致——静默失败，日志里一行 warn 都没有。

通知挂状态出口

发货、取消、退款成功。集中发。别在 Controller 里复制粘贴三份。抽 SubscribeMessageService：

<?php
SubscribeMessage::send($userId, 'order_shipped', [
    'character_string1' => ['value' => $order->order_sn],
    'thing2'            => ['value' => mb_substr($expressName, 0, 20)],
    'character_string3' => ['value' => $trackingNo],
    'date4'             => ['value' => date('Y-m-d H:i')],
]);

字段名 character_string1 必须和微信公众平台模板完全一致。差一个数字，发送成功率为零。零。不是接近零，是零。

我踩过的坑清单

• 模板换了，代码还传旧字段名
• thing 类型超 20 字被截断或拒收
• 用户没授权该模板，发送失败当成功
• access_token 过期没刷新

每条都要日志带 order_sn 和微信返回原文。否则「没收到」你抓瞎。抓瞎的夜晚特别长。

用户不授权怎么办

降级站内信或短信。别卡发货。包裹先走，通知后补。有人非要强绑授权才给下单，转化掉一截，别怪我没提醒。

排期说人话

代码两天。联调可能两周。类目不符模板会被拒。备两条文案。别卡在上线当天。上线当天被拒，产品会看你。客服也会看你。

验收

真机授权、真发货、真收到。缺一步都不算完。后台显示已发送不算，用户口袋里有才算。

模板版本管理

运营换模板，代码字段名跟着换。我在后台模板配置里加「字段映射 JSON」，运营改模板 ID 时对照文档改映射。映射错了发送失败，日志里写「字段 xxx 不存在」。比静默失败强。静默失败最恨人。

和短信的分工

发货通知：订阅优先，失败再短信。营销别双通道轰炸。轰炸完用户退订，你啥也剩不下。退订了再花钱拉回来，比一开始别轰炸贵。贵很多。