使用OneSignal时，iOS端PWA点击Web推送通知跳转失效问题

• 检查PWA Manifest配置
  确保manifest.json里的start_url正确，scope覆盖推送跳转的目标页面路径——iOS对PWA的scope限制严格，跳转URL不在范围内的话，会直接打开start_url而非目标页。示例配置：

  {
    "start_url": "/",
    "scope": "/",
    "display": "standalone"
  }
  

  同时确认display设为standalone或fullscreen，这是iOS PWA支持推送跳转的必要条件。

• 修正OneSignal推送Payload
  推送的url字段必须是带完整协议（https://）的绝对路径，不能用相对路径，且URL要和PWA的origin完全一致——iOS会拦截跨origin的跳转。正确示例：

  const payload = {
    app_id: "YOUR_APP_ID",
    contents: { en: "测试通知" },
    url: "https://your-domain.com/target-page"
  };
  

  后台状态下的iOS PWA无法解析相对路径，务必避免使用。

• 完善Service Worker的事件监听
  iOS PWA后台挂起时，跳转逻辑依赖notificationclick事件的正确处理。在service worker里注册事件，手动打开目标页面：

  self.addEventListener('notificationclick', function(event) {
    event.notification.close();
    // 强制打开目标页，避免复用现有窗口导致的异常
    event.waitUntil(
      clients.openWindow(event.notification.data.url || event.notification.url)
    );
  });
  

  如果PWA处于前台，默认跳转可能不触发，需要在前台的通知回调里手动处理路由跳转。

• 验证iOS版本与PWA添加状态
  iOS 15及以下版本的PWA推送存在已知bug，建议升级到最新系统；另外，必须确保用户已经将PWA添加到主屏幕，未添加的话推送跳转行为会异常。

• 更新OneSignal SDK版本
  旧版OneSignal Web SDK可能存在iOS PWA适配问题，检查并替换为最新版SDK：

  <script src="https://cdn.onesignal.com/sdks/OneSignalSDK.js" async></script>
  

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