【踩坑系列】发送微信模板消息返回40165 invalid weapp pagepath
1. 踩坑经历
最近做了个需求，需要往公司微信公众号推送一个模板消息，并且点击该消息需要跳转到公司小程序的某个页面。
1.1 拿到模板id
既然是发送模板消息，第一步就需要登录微信公众号后台新建模板消息，拿到模板id。
登录地址：
https://mp.weixin.qq.com
新建模板消息的方法如下所示：
1)在左侧“广告与服务”菜单下找到“模板消息”菜单
2)点击”从历史模板库中添加“按钮
3)找到合适的模板后，点击”详情”，打开模板详情页
4)在模板详情页点击”添加“按钮，将模板添加到自己的公众号中
5)添加完成后，就可以拿到模板id
1.2 调用发送模板消息接口
模板消息接口文档：
https://developers.weixin.qq.com/doc/offiaccount/Message_Management/Template_Message_Interface.html
发送模板消息接口：
https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=
按照接口文档要求，最终调用接口的请求报文大致如下所示：
{
"template_id":"RJr0LvTwWtwKNNeorUtfBF-ClwCRCB9GAfO55H6DjtE",
"touser":"oYLSx0S7Oci-kbNIrPA461q9g1iE",
"data":{
"first":{
"color":"",
"value":"尊敬的客户,感谢您选择****,\n以下为*****交易风险提示"
},
"keyword1":{
"color":"",
"value":"沪C88V88"
},
"keyword2":{
"color":"",
"value":"2023年03月28日 15:56"
},
"keyword3":{
"color":"",
"value":"*****交易风险提示\n为保障您的财产安全，谨防法律风险，***提醒您，请遵循平台交易流程，切勿与任何非平台第三方单独/私下交易，\n如您遇到有****买家或员工向您表示想私下交易的，可向平台进行举报，经查证属实可获奖励 800 元／单。\n"
},
"remark":{
"color":"#fe2d46",
"value":"如需举报，请点击本条消息 >>>"
}
},
"miniprogram":{
"appid":"wx356234er34567dv",
"pagepath":"pages/order/detail?id=23"
}
}
说明：
1)如果模板消息中的内容需要换行，如上面的first里的内容，可以使用换行符\n。
2)如果模板消息中的内容需要自定义字体颜色，如上面的remark里的内容，可以给color赋值为自定义的颜色。
提测后，测试反馈一直收不到微信模板消息，查看日志后，发现调用发送模板消息接口后，一直返回40165这个错误码，消息未发送成功。
响应报文如下所示：
{
"errcode":40165,
"errmsg":"invalid weapp pagepath rid: 64229d9f-2e863b15-2db557df"
}
2. 原因分析
看到40165这个错误码，想先去微信接口文档中查找下这个错误码的说明，结果文档中并没有找到，
然后根据errmsg的提示猜测可能是小程序的跳转地址，微信识别不了，所以代码先把跳转小程序的部分注释了，再次发送，
发现消息发送成功了，证实消息发送失败确实是因为小程序跳转地址导致的。
和前端沟通后，得知这个跳转地址，是本次需求新加的，处于小程序的开发版中，小程序正式版中暂时没有该地址，
所以导致发送微信模板消息一直报这个错。
3. 解决方案
经过证实，不管小程序是
开发版
，还是
体验版
，只要不是
正式版
，新加的这个页面地址，发送微信模板消息就是识别不了，
一直返回40165这个错误码，直到小程序审核通过成为
正式版
后，这个地址才被识别，发送消息终于成功了：
{
"errcode":0,
"errmsg":"ok",
"msgid":2868541260507217920
}
说点别的，因为发送微信模板消息跳转小程序有上面的这个问题，所以在做这种需求时，业务系统最好加个配置开关，上线时，先关闭该
开关，等小程序审核通过成为
正式版
后，再打开开关，不然在这之前的推送会全部失败。
文章持续更新，欢迎关注微信公众号「申城异乡人」第一时间阅读！