天呐！真的是气死我了搞个待办消息怎么这么难？！

今天是2025年10月23日外面风hen大，我的心情比外面的风还要乱。你说咱们Zuo个开发者容易吗？老板非要在微信小程序里搞一个“待办事项”的功Neng， 而且还要求即使用户不打开小程序，也Neng收到像闹钟一样的提醒。我当时就笑了我说老板你是不是傻？那是系统级的权限啊！后来我想想， 不对，虽然订阅消息限制多到让人想吐——必须要用户主动点订阅、还得有交互才Neng发一次——dan是咱们不是还有那个万恶的关联公众号嘛，百感交集。！

说干就干，后来啊一查文档，那一堆乱七八糟的文字kan得我脑瓜子嗡嗡的。什么tong过微信小程序给关联公众号发送消息提醒2025-02-11 15:38... 这些时间戳是怎么回事？ 瞎扯。 感觉像是穿越了一样。

不管怎么说既然要实战指南，那咱们就得把这一地鸡毛给捋顺了。

第一步：你是不是“亲生的”？

这是ZuiZuiZui基础的一点，也是Zui容易让人原地爆炸的一点。第一:小程序和公众号的主体必须是同一个。 听懂了吗？必须是同一个！如guo你的小程序是你个人的，而公众号是你公司的认证服务号，那你就别想了洗洗睡吧，神仙也救不了你，太虐了。。

你得有一个tong过了微信认证的服务号。注意啊，必须是服务号！订阅号是没有这个模板消息的高级功Neng的。而且这两个账号——小程序和公众号，dou得绑定在同一个微信开放平台账号下。 观感极佳。 如guo不绑定开放平台，你怎么知道这个在小程序里叫“张三”的用户，在公众号里是不是也叫“张三”？这就涉及到了那个大名鼎鼎的UnionID机制。

我记得有一次就是主要原因是主体不一致， 折腾了两天两夜，再说说发现是运营注册的时候选错了主体类型，我当时真的想把键盘吃了，体验感拉满。。

第二步：后台那些乱七八糟的设置

动手。 进了后台别晕。在小程序管理员后台- 会员管理- 通知处,关联公众号后面点击双向箭头,可yi切换关联的公众号. 这个地方其实挺好玩的，像是一个遥控器。如guo你的账号关联了好几个公众号，你可yi在这里选你要用哪一个来发消息。

ran后呢，在模板/订阅消息后面点击刷新按钮,可yi重新刷新/获取公众号模板消息以及小程序订阅消息。 我每次点这个刷新按钮的时候dou特bie紧张，生怕它报错huo者转圈圈转个没完没了。有时候网络不好，真的Neng把人急死。

这里必须啰嗦一句：第三:我们得有消息模板,小程序消息模板和公众号消息模板dou可yi。 dan是为了达到我们“待办”的目的，明摆着是用公众号的模板消息geng靠谱一点嘛。毕竟而订阅消息的使用限制比较大,用户必须得订阅、 需要获取用户同意接收消息的权限、用户必须得和小程序有交互的时候才Neng发送且只Neng发送一次. 这么多限制听着就头大，谁受得了啊？suo以咱们走统一服务接口这条路，弄一下...。

核心来了：UniformMessage.send 接口调用详解

重头戏来了兄弟们。3、 tong过小程序中的 下发小程序和 泰酷辣！ 公众号统一的服务消息接口链接发送关注模板消息,接口链接如下.

这里有一个巨大的坑，无数英雄好汉dou在这里折戟沉沙了。微信小程序:AppId和APPSecret.1、access_token这个接口中的access_token必须是小程序的access_token,不Neng使用公众号的,主要原因是官方黑这个接口就是想大家在开发小程序的时候,如guo要发送公众号消息直接使用这个接口就可yi了,无需再去调用公众....，太治愈了。

kan到没？kan到没？！一定要用小程序的 Access Token！千万别手贱去用公众号的那个 Token 调用 `uniformMessage.send` 这个接口。我就犯过这种低级错误， 当时一直报错 `errcode 48001`，也就是 API 接口权限未授权huo者是非法调用。那时候我真的是kan着屏幕怀疑人生。

记录一次微信小程序tong过公众号发送模板消息报错errcode 48001 的解决过程. 解决过程hen简单也hen残酷：换 Token！ 我跪了。 换成你那个该死的小程序的 AppID 和 AppSecret 换取出来的 Token 就行了。

代码层面的痛苦

Coding 其实是Zui简单的部分，难的是心态稳住。你 坦白说... 需要构造一个 JSON 包包发给腾讯的服务器。大概长这样：

{
  "touser": "用户的OpenID",
  "weapp_template_msg": {
    "page": "index/index",
    "data": {
        "thing1": {"value": "写代码"},
        "time2": {"value": "2025-10-24 10:00"}
    }
  },
  "mp_template_msg": {
    "appid": "你的公众号AppID",
    "template_id": "你的模板ID",
    "url": "http://www.baidu.com", // 哦不对不Neng有网址
    "miniprogram": {
        "appid": "你的小程序AppID",
        "pagepath": "pages/index/index"
    },
    "data": {
        "first": {"value": "你有新待办啦"},
        "keyword1": {"value": "别摸鱼了"},
        ...
    }
  }
}

Sring Boot 微信小 程序和 公众 号开发完整 指南 . 这种书我也买过几本说实话大部分时间dou在讲废话还不如 原来如此。 直接kan官方文档来得快dan是官方文档有时候排版真的hen丑kan得人眼睛疼就像我现在写的这篇文章一样充满了语病和废话。

那些年我们遇到的奇葩报错与解决方案

若想实现 从小程序触发,向用户推送公众号模板消息 换个思路。 的功Neng,就需要打通二者之间的用户身份体系.

错误码 含义 解决方案 当时的心情 40037 template_id 不正确 去后台复制 ID 别手打! 烦躁 41030 page 路径不对 检查参数前面有没有斜杠! 疑惑 48001 bai API 接口权限不足/Token 错误 .换回 小程序的 Token! 别再搞错了! 崩溃大哭 45009 bai 接口调用超过限制 .控制频率 别给一个人发一万条! 无奈摊手 40003 touser OpenID 错误 .用户没关注? 还是 ID 拿错了? 绝望 常见报错情绪对照表 v1.0，脑子呢？

bai guan与用户授权的那些破事儿

不靠谱。 .还有一个hen重要的事情忘了说了 .本文将详细介绍如何利用微信开放平台的UnionID 机制,实现. .dan是! 如guo用户没有关注你的服务号怎么办? 那就没戏了呗 . 发送个空气吗? suo以在Zuo这个功Neng之前Zui好先判断一下用户的关注状态 . 如guo没关注引导他去关注huo者干脆就在前端提示他 “请先关注我们的公众号否则收不到提醒哦” 这样比较诚实 . 我之前试过偷偷摸摸发后来啊根本发不出去只会在后台日志里留下一串冷冰冰的错误代码 . . bai 应用场景与再说说的碎碎念 . .其实除了 . .再说说再说一句废话吧 . 开发这行真的不容易特bie是对接腾讯这种巨头的 API 动不动就改文档动不动就封接口动不动就限流 . 今天这篇东西写得乱七八糟也没什么逻辑纯粹是主要原因是我刚刚修完一个 bug 还没缓过劲来脑子是一团浆糊 . 如guo你Neng从这篇文字里哪怕学到一点点东西那也算是我的功德无量了 . 如guo没kan懂也别骂我毕竟我也没收你的钱对吧 ? . .哦对了还有一点 . 这些dou是些套话大家听听就算了 . 还是赶紧回去改 bug 吧 ! 加油啊打工人 ! . .2025-10-23 11:04..天呐！深得我心。 3、 tong过小程序中的 下发小程序和公众号统一的服务接口链接链接如下. 这里有一个巨大的坑，无数英雄好汉dou在这里折戟沉沙了。 dan是为了达到我们“待办”的目的，明摆着是用公众号的模板消息geng靠谱一点嘛。毕竟而订阅的消息的使用限制比较大,用户必须得订阅、 需要获取用户同意接收消息的权限、用户必须得和小程序有交互的时候才Neng发送且只Neng发送一次. 这么多限制听着就头大，谁受得了啊？suo以咱们走统一服务接口这条路。 核心来了：UniformMessage.send 接口调用详解 重头戏来了兄弟们。如guo你的账号关联了好几个公众号，你可yi在这里选你要用哪一个来发消息。 ran后呢， 在模板/订阅消息后面点击刷新按钮,可yi重新刷新/获取公众号模板消息以及小程序订阅消息. 我每次点这个刷新按钮的时候dou特bie紧张，生怕它报错huo者转圈圈转个没完没了。有时候网络不好，真的Neng把人急死。 这里必须啰嗦一句：第三:我们得有消息模板,小程序消息模板和公众号消息模板dou可yi。如guo不绑定开放平台， 你怎么知道这个在小程序里叫“张三”的用户，在公众号里是不是也叫“张三”？这就涉及到了那个大名鼎鼎的UnionID机制。 我记得有一次就是主要原因是主体不一致， 折腾了两天两夜，再说说发现是运营注册的时候选错了主体类型，我当时真的想把键盘吃了。 第二步：后台那些乱七八糟的设置 进了后台别晕。在小程序管理员后台- 会员管理- 通知处,关联公众号后面点击双向箭头,可yi切换关联的公众号. 这个地方其实挺好玩的，像是一个遥控器。第一:小程序和公众号的主体必须是同一个。 听懂了吗？必须是同一个！如guo你的小程序是你个人的，而公众号是你公司的认证服务号，那你就别想了洗洗睡吧，神仙也救不了你。 你得有一个tong过了微信认证的服务号。注意啊，必须是服务号！订阅号是没有这个模板消息的高级功Neng的。而且这两个账号——小程序和公众号，dou得绑定在同一个微信开放平台账号下。说干就干，后来啊一查文档，那一堆乱七八糟的文字kan得我脑瓜子嗡嗡的。什么tong过微信小程序给关联公众号发送消息提醒2025-02-11 15:38... 这些时间戳是怎么回事？感觉像是穿越了一样。 好吧好吧... 不管怎么说既然要实战指南，那咱们就得把这一地鸡毛给捋顺了。 第一步：你是不是“亲生的”？ 这是ZuiZuiZui基础的一点，也是Zui容易让人原地爆炸的一点。