iOS端PWA推送通知无法显示问题排查与方案咨询

一、无iOS设备的测试方法 #

• Safari Technology Preview 模拟测试：在macOS上安装该版本Safari，它完全支持iOS 16.4+的Web Push特性，可模拟iOS端PWA的订阅、推送场景，还能通过开发者工具查看推送日志，定位问题。
• 直接调用APNS接口验证：用curl构造请求，代入MongoDB中存储的iOS订阅信息（endpoint、p256dh、auth）和你的VAPID密钥，根据返回状态码判断问题：
  • 200：推送成功
  • 400：Payload格式错误
  • 403：VAPID认证失败
  • 410：订阅已失效
    示例请求（替换占位符）：

  curl -X POST "https://web.push.apple.com/xxxxxx" \
    -H "Authorization: vapid t=你的VAPID令牌,k=你的VAPID公钥" \
    -H "Content-Type: application/json" \
    -H "Encryption: salt=你的auth参数; dh=你的p256dh参数" \
    -H "Crypto-Key: dh=你的p256dh参数" \
    -d '{
          "aps": {
            "alert": {
              "title": "测试推送",
              "body": "这是一条测试消息"
            },
            "badge": 1
          }
        }'
  

• 利用web-push库的错误反馈：在Spring Boot服务中调用sendNotification时，捕获并打印错误信息，库会透传APNS的响应，直接定位是认证、订阅还是Payload问题。

二、bouncycastle依赖是否需要 #

不需要。nl.martijndwars/web-push 5.1.1版本已内置Web Push所需的ECDH、AES-GCM加密实现，无需额外引入bouncycastle，除非你自定义了加密逻辑，否则可直接移除该依赖。

三、是否需要证书 #

不需要传统APNS推送证书。苹果Web Push采用VAPID认证机制，只要你在web-push配置中正确设置了P-256曲线的VAPID公钥和私钥，库会自动生成符合APNS要求的认证令牌，完成身份验证。

四、是否需要借助Pushy对接APNS #

不需要。web-push库原生支持APNS协议，当检测到订阅endpoint为苹果https://web.push.apple.com/开头时，会自动切换到APNS推送逻辑，无需额外集成Pushy或其他APNS客户端。

额外排查建议 #

• 确认VAPID密钥合规：必须是P-256曲线生成的，且公钥已正确配置到Angular PWA的manifest或推送请求中。
• 检查Payload格式：iOS要求推送内容必须包裹在aps字段内，alert需包含title和body字段，不能直接复用Android的Payload格式。
• 验证测试设备配置：确保Safari版本≥16.4，已开启实验性设置中的Push API和Notifications，且PWA已添加到主屏幕（仅主屏幕PWA可接收推送）。

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