网页推送：通知未显示

当通知在 OneSignal 中显示为”已送达”时，意味着我们已成功将通知发送到 FCM（Google）/ APNs（Apple）/ WNS（Microsoft）服务器，然后这些服务器将通知分发给您的订阅者。以下是通知可能显示为”已送达”但在您的设备上不可见的原因。

​

设备设置

设备通知设置是Web推送通知无法显示的最常见原因。请在检查其他问题之前，先检查以下设置（包括勿扰模式、低电量等专注模式）。

​

网络问题 - 无互联网

设备必须在线才能接收推送通知。如果设备关闭、处于飞行模式、网络连接不稳定或无互联网连接，推送将不会显示，直到建立适当的连接。您可以使用生存时间 (TTL) 参数设置 FCM 和 APNs 等待连接的时间（默认为 3 天）。 如果设备连接的 WiFi 网络使用防火墙或 VPN，该网络可能会阻止与 Apple 或 Google 服务器的连接。请切换到蜂窝数据进行测试。 如果您通过防火墙管理网络流量，请将其配置为允许以下内容：

• FCM（Chrome、Android）： 出站 TCP 端口 5228、5229 和 5230。完整要求请参阅 FCM 文档。
• APNS（Safari、iOS）： 出站 TCP 端口 5223 以及 TCP 端口 443 或 2197。完整要求请参阅 Apple 文档。

---

​

浏览器设置

您的浏览器有其独立于操作系统设置的通知权限设置。即使操作系统为浏览器启用了通知，网站也可能在浏览器层面被屏蔽。

• Chrome：访问 chrome://settings/content/notifications，确认您的网站列在”允许发送通知”下，而非”不允许发送通知”下。
• Firefox：访问 about:preferences#privacy，滚动到权限 > 通知，点击设置检查您网站的状态。
• Edge：访问 edge://settings/content/notifications，确认您的网站已被允许。
• Safari：访问 Safari > 设置 > 网站 > 通知，确认您的网站设置为允许。

​

浏览器已关闭

浏览器除非运行，否则不会显示推送通知。如果您在已发送通知的生存时间 (TTL) 到期之前打开浏览器，通知将弹出显示。

​

不支持的浏览器

用户必须在其桌面或移动设备上订阅通知才能接收通知，并且必须是支持推送通知的浏览器。请参阅网页推送常见问题了解支持的网页平台。

​

移动浏览器应用数据已满

如果您的移动浏览器应用已达到其数据限制或数据已满，您需要清除应用上的数据。 如果您的移动浏览器应用有许多未读推送通知和/或打开了许多选项卡，这可能会导致通知无法显示。

---

​

用户订阅

确保您的设备仍然订阅并被定向到推送通知。

​

订阅资格

检查消息受众，确认您的网页推送订阅已包含在内：

• 细分：确认您的订阅符合所有受众筛选条件。
• 直接发送：确认您定向的 ID 是正确的：
  • 该订阅仍订阅了推送。
  • 它有最近的最后会话日期——您可能正在向旧的或非活跃的订阅发送消息。

使用下方的调试步骤查找您的订阅 ID 并确认其已订阅且处于活跃状态。

---

​

网站代码库

​

注销服务工作线程或添加 PWA

检查您网站的代码库中是否有 .unregister() 方法。调用此方法将删除服务工作线程。有关此方法的详细信息，请参阅此指南。 如果您有另一个服务工作线程（如用于您的 PWA），您需要遵循我们的集成多个服务工作线程的服务工作线程指南。

---

​

调试网页推送通知

按照以下步骤获取干净的网页推送订阅并确认网页推送端到端正常工作。