You need to enable JavaScript to run this app. PHP发送VoIP Push Notification成功但iOS端未接收问题求助
优惠活动
大模型
产品
解决方案
定价
更多

PHP发送VoIP Push Notification成功但iOS端未接收问题求助

PushKit通知无法接收排查方案

1 核心问题:旧APNs二进制接口已停用

你当前使用的ssl://gateway.push.apple.com:2195是苹果早已废弃的二进制APNs接口,苹果在2021年3月就全面停止了该接口的服务。你的代码中仅判断了fwrite写入socket成功,没有读取苹果返回的错误帧,所谓的"Message successfully delivered"只是本地写入成功的提示,不代表苹果服务器接受并下发了这条推送。
另外你当前代码同时向生产和沙箱两个推送接口发送同一条推送,而同一个DeviceToken只能对应一个环境,必然有一个请求是无效的,建议根据你的打包环境选择对应的推送接口,不要同时发送。

2 其他可能的排查点

  • PushKit合规校验:iOS13及以上系统要求,收到PushKit VoIP通知后必须在系统要求的时限内调用CallKit接口上报来电,多次违规后系统会直接屏蔽当前App的所有PushKit通知送达,即使服务器推送成功也无法触发回调。请检查didReceiveIncomingPushWith方法内是否漏了CallKit的调用逻辑,有没有修改过该方法的执行流程。
  • 证书与环境匹配校验:确认你使用的PEM证书是VoIP专用推送证书,没有过期;同时确认DeviceToken和推送环境匹配:开发环境DeviceToken只能用开发证书推沙箱地址,生产环境DeviceToken只能用生产证书推生产地址,环境不匹配也会导致推送被苹果丢弃。
  • Payload格式校验:PushKit推送的Payload必须指定apns-topic字段,取值为你的App Bundle ID加.voip后缀(例如Bundle ID为com.example.app时,topic为com.example.app.voip),同时Payload总大小不能超过4KB。

3 修复方案

直接替换为苹果官方要求的HTTP/2版本APNs接口,新接口会返回明确的错误码,可直接定位推送失败原因,以下是PHP实现的极简示例:

// 生成JWT或者直接用证书方式发起HTTP/2请求,此处为证书示例
$ch = curl_init();
// 生产环境地址为https://api.push.apple.com,沙箱环境替换为https://api.sandbox.push.apple.com
curl_setopt($ch, CURLOPT_URL, 'https://api.push.apple.com/3/device/' . $deviceToken);
curl_setopt($ch, CURLOPT_PORT, 443);
curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_2_0);
curl_setopt($ch, CURLOPT_SSLCERT, $pem_url);
curl_setopt($ch, CURLOPT_SSLCERTPASSWD, $passpem);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'apns-topic: com.your.bundle.id.voip', // 替换为你自己的voip topic
    'apns-push-type: voip'
]);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
// 返回200为推送成功,其他状态码可直接对应苹果官方错误原因
curl_close($ch);

内容的提问来源于stack exchange,提问作者qian-yu

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.19 05:54:00