跳转到主要内容
如果您的网站有问题但没有移动应用,请参阅我们的网页推送故障排除指南

故障排除步骤

1. 查看设置说明并更新 OneSignal SDK

我们的移动 SDK 设置说明旨在帮助预防常见问题并测试集成。 我们经常发布更新,包含错误修复、改进和对最新操作系统更改的支持。 如果您遇到问题,请首先确保您使用的是我们最新的 SDK 版本并遵循了设置说明。

2. 常见故障排除指南

3. 测试您 SDK 的示例项目

检查您的问题是否可以使用我们工程团队为每个 SDK 创建的构建来重现。

4. 检查错误日志

在诊断问题之前,收集日志数据很重要:
  • 遵循我们关于捕获调试日志的指南。
  • 查找可能解释该行为的错误、警告或弃用通知。

5. 联系支持

如果您仍有问题:
  • 联系 support@onesignal.com 并提供:
    • 您的 OneSignal 应用 ID。
    • 您遇到问题的设备的外部 ID 和/或订阅 ID。
    • 通知 ID 或 OneSignal 仪表板中通知的链接(如适用)。
    • 如果可能,提供设备调试日志重现问题。

常见错误

APNS 委托从未触发

像”Apns Delegate Never Fired”和”APNS 3000”这样的 APNS 错误是 Apple 提供的超时消息,表示设备无法与推送通知所需的 Apple APNS 服务器建立连接。这在以下情况下最常见:
  • 在 APNS 开发环境中测试
  • 如果您将多个推送通知依赖项或原生 iOS 推送 API 与 OneSignal 一起使用
  • 临时错误,会在用户下次开始新会话时自动解决(应用失去焦点 30 秒以上,然后再次打开)。
解决步骤:
  • 移除任何其他推送通知依赖项或原生 iOS 推送 API,仅使用 OneSignal。一旦错误解决,您可以尝试添加回其他代码并联系 support@onesignal.com 获取最佳实践。
  • 检查设备调试日志了解更多详情。
  • 如果错误持续存在,请按照这些步骤联系支持

常见问题

如果我在应用中更改 OneSignal 应用 ID 会发生什么?

在您应用的初始化代码中更改 OneSignal 应用 ID 将在用户更新并打开应用到最新版本时在新应用 ID 下创建全新的用户和推送订阅。 如果您的 iOS bundle ID 和/或 Android package ID 相同,那么设备将继续保持相同的推送订阅状态。用户数据将是全新的,即您需要在新记录上重新添加您的别名、标签、电子邮件地址、电话号码。 如果 iOS bundle ID 或 Android package ID 不同,那么这是一个全新的应用,应该有不同的推送证书/密钥。

OneSignal 可以在本地部署的封闭网络中发送推送通知吗?

只要您封闭网络上的计算机可以访问您要支持的推送网关服务器,这就可以工作: 如果网络完全与互联网断开连接,则无法通过标准操作系统/浏览器服务传递推送通知,这是我们支持的。
I