支付宝生活号模板消息必须通过alipay.open.app.mini.templatemessage.send接口发送，且需绑定生活号、使用生活号user_id和专用form_id，参数user_template_data须双重json编码，权限链路任一环节缺失均导致失败。
支付宝生活号模板消息在 ThinkPHP 中能推，但必须走「生活号」通道，不是普通小程序模板消息接口；用错接口、没绑定生活号、form_id 类型不匹配，三者任一都会返回 INVALID_PARAMETER 或 NO_PERMISSION。
alipay.open.app.mini.templatemessage.send 接口必须绑定生活号
这个接口名义上叫“小程序模板消息”，实际是生活号专属通道。即使你调用的是小程序的 SDK，只要没把小程序绑定到生活号下，请求会直接被拒绝。
- 检查路径：支付宝开放平台 → 生活号管理 → 查看是否已关联目标小程序
- 绑定后需等待 1–2 小时生效，不能立即推送
- 接口中
to_user_id必须填用户在生活号下的user_id（不是小程序 openid），可通过生活号授权回调拿到 - 如果误填了小程序的
open_id，错误码通常是USER_NOT_EXIST
form_id 必须来自生活号场景，不能复用小程序 form 组件
生活号模板消息要求 form_id 来自生活号页面内的交互（如生活号 H5 页面里的按钮、表单提交），而非小程序内收集的 form_id。后者调用该接口会报 FORM_ID_INVALID。
- 生活号 H5 页面需引入支付宝 JSAPI：
https://appx.alipay.com/appx-bridge-web/1.0.0/appx-bridge.min.js - 调用
my.formId.get获取生活号专用form_id，有效期 7 天 - ThinkPHP 后端接收时要校验
form_id长度（通常为 32 位字符串）和格式，避免传入空值或支付单号（如2026050122001483240500000000）混用
ThinkPHP 中调用时注意参数嵌套和签名方式
EasySDK 的 asyncExecute 默认对 bizContent 做 JSON 编码，但生活号模板消息接口要求最外层参数是扁平结构，user_template_data 字段必须是 JSON 字符串（即双重 encode）。
- 错误写法：
'user_template_data' => ['keyword1' => ['value' => 'xxx']]→ 签名失败 - 正确写法：
'user_template_data' => json_encode(['keyword1' => ['value' => 'xxx']]) -
page参数只支持生活号内已备案的页面路径，如pages/index/index，不能填小程序路径或外部 URL - ThinkPHP 6+ 使用
AlipayEasySDKKernelFactory时，务必确认signType设为RSA2，且private_key是 PEM 格式（含-----BEGIN PRIVATE KEY-----头尾）
调试失败时优先检查 response 中的 sub_code
支付宝返回的 code 为 10000 只代表网关通，真正失败藏在 sub_code 里。ThinkPHP 日志中必须记录完整响应体，不能只判 code。
-
sub_code = "TEMPLATE_NOT_EXIST"→ 模板 ID 未在生活号下启用，要去生活号后台「模板消息」页重新领用 -
sub_code = "USER_NOT_AUTHED"→ 用户未对生活号授权模板消息，需引导其进入生活号主页点击“允许通知” -
sub_code = "FORM_EXPIRED"→form_id超过 7 天，需前端重新触发获取 - 所有错误响应中
msg和sub_msg是中文描述，但日志中应同时保留原始 JSON，方便比对文档
生活号模板消息真正的门槛不在代码，而在支付宝后台的权限链路：生活号绑定 → 模板领用 → 用户授权 → form_id 场景隔离。任何一个环节断开，后端再怎么重试都无效。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
