在TP5.1中初始化JPush客户端需封装为单例服务类，从config/jpush.php读取appkey和master_secret，避免硬编码；使用think\Container绑定或控制器手动实例化，确保HTTP连接复用。
TP5.1 项目接入 JPush，核心在于服务端调用 SDK 发起推送、客户端上报设备标识（如 registration_id），并用别名（alias）建立用户与设备的稳定映射。状态回执不是默认开启的，必须显式配置回调地址并处理极光返回的 msg_id 和后续的回执事件。
怎么在 TP5.1 中初始化 JPush 客户端？
别直接 new Client，得封装成可复用的服务类，并确保密钥不硬编码。
-
appkey和master_secret必须从配置文件读取（如config/jpush.php），避免泄露到代码中 - 推荐使用单例模式管理
JPush\Client实例，防止重复创建 HTTP 连接池 - TP5.1 的依赖注入支持有限，可在控制器构造函数中手动实例化，或通过
think\Container绑定服务 - 注意：PHP SDK 默认使用 cURL，若服务器禁用了
curl_setopt或 SSL 验证失败，会抛出APIConnectionException
如何给用户绑定 alias 并保证唯一性？
alias 不是“注册一次就永久有效”，它本质是设备级绑定，一个 alias 最多关联 10 个 registration_id；且需客户端主动调用 JPushInterface.setAlias() 上报，服务端无法强制设置。
- 客户端（Android/iOS）必须在登录成功后、获取到
registration_id的第一时间调用 setAlias，参数为用户唯一标识（如uid_12345） - 服务端推送时用
audience => ['alias' => ['uid_12345']]，不能写成字符串'uid_12345'，否则报错Invalid audience format - 用户登出或切换账号时，客户端要调用
deleteAlias清理旧绑定，否则可能出现消息推送给错误账号 - 别名长度限制为 1–64 字符，只支持字母、数字、下划线和短横线，含中文或特殊符号会触发
400 Bad Request
推送后怎么拿到 msg_id 并监听送达/点击回执？
TP5.1 本身不提供回执监听能力，必须靠极光的「推送结果回调」机制，即你提供一个公网可访问的 URL，极光在消息送达/点击后 POST 数据过来。
- 推送请求中必须带上
options => ['sendno' => time(), 'apns_production' => true, 'time_to_live' => 86400]，其中sendno是你自己生成的唯一序号，用于后续匹配回执 - 在极光后台「应用设置 → 推送设置 → 结果回调」里填写你的回调地址（如
/api/jpush/callback），协议必须是 HTTPS，且需校验X-JPUSH-SIGNATURE请求头 - 回调接口需解析 JSON body，关键字段包括
msg_id（极光内部 ID）、sendno（你传的序号）、status（received/clicked）、platform、registration_id - TP5.1 中建议用
input('post.')获取原始 POST 数据，再用file_get_contents('php://input')解析 JSON，避免自动解析破坏签名验证
常见失败场景和调试要点
别名推送失败往往不是代码问题，而是环境或配置断点卡住。
- 客户端没调用
setAlias或调用失败（检查 Logcat / Xcode 控制台是否有JPush: Set alias failed） - 服务端推送时用了已过期的
registration_id（Android 设备重装 App 或厂商通道限制会导致 ID 变更） - 回调地址无法被极光服务器访问（防火墙拦截、Nginx 未转发、TP5.1 路由未开放 POST）
- 签名验证失败：极光回调的
X-JPUSH-SIGNATURE是sha256(appkey + master_secret + json_body)，注意 body 必须是原始字节流，不能先 decode 再 encode - 测试时别用模拟器——JPush Android 模拟器不支持推送，iOS 模拟器根本收不到 APNs
真正麻烦的是 alias 生命周期管理和回执数据去重。一个用户可能有多个设备，每次登录都重新 setAlias，但旧设备不会自动解绑；回执可能重复到达，需要按 msg_id + registration_id + status 做幂等写入。
