如何检查APNS接收的Drupal后端推送数据？自定义字段丢失排查

苹果官方有两种核心机制可以检查APNS接收和传递的payload数据：

1. 使用Mac控制台应用（Console.app）排查设备端接收情况 #

连接你的iOS设备到Mac，打开Console.app，在左侧设备列表中选中你的设备，然后在搜索栏输入apns或pushd（推送相关进程关键词）。当Drupal后端发送通知后，你可以在控制台日志中找到APNS相关的条目，这些日志会显示APNS服务器传递给设备的完整payload内容。

• 如果日志里也没有context字段，说明问题出在Drupal后端的发送环节（比如payload构造错误、传输时被截断）；
• 如果日志里有context但你的代码中拿不到，那就是代码处理逻辑的问题，需要检查代理方法中对userInfo的处理是否正确。

2. 直接调用APNS API发送测试payload验证 #

你可以用curl命令模拟Drupal的请求，向APNS服务器发送和Drupal相同格式的payload，验证APNS是否能正常处理并转发自定义字段：
示例curl命令（需替换证书、设备token等信息）：

curl -v \
--header "apns-topic: com.your.app.bundleid" \
--header "apns-push-type: alert" \
--cert /path/to/your/cert.pem \
--key /path/to/your/key.pem \
https://api.sandbox.push.apple.com/3/device/<your-device-token> \
-d '{
"aps": {
    "alert": {
    "title": "Title of APN",
    "body": "Body of APN"
    },
    "badge": 32
},
"context": {
            "site_name": "***",
            "path": "***",
            "uid": "***",
            "site_id": "example.com",
            "type": "***",
            "entity_id": "***"
        }
}'

• 如果APNS返回成功响应（HTTP 200），且设备端能收到包含context的完整payload，说明Drupal后端的发送流程存在问题；
• 如果APNS返回错误，根据错误信息可以定位payload是否符合规范（比如JSON语法错误、字段格式不合法等）。

额外排查要点 #

• 确认Drupal发送的payload严格符合APNS规范：自定义字段必须和aps字段同级，不能嵌套在aps内部，同时JSON语法必须完全正确；
• 检查Drupal使用的推送证书环境（开发/生产）是否和你的设备运行环境匹配，环境不匹配可能导致payload被过滤；
• 代码中确保完整打印userInfo字典，而不是仅提取aps部分，避免遗漏自定义字段。

内容的提问来源于stack exchange，提问作者Sanjay Borkakoty