白标iOS版Rocket.chat应用通知功能无法正常工作

一、基础权限与推送配置验证 #

• 确认Info.plist推送权限配置：
  检查NSUserNotificationUsageDescription（通知权限描述）、NSRemoteNotificationType（对应iOS版本权限键）是否配置正确，虽然首次启动能弹出权限请求，但需确保键值无拼写或格式错误。
• 检查Xcode项目Signing & Capabilities：
  • 已开启Push Notifications能力，且绑定的Provisioning Profile包含推送权限（需对应开发/生产环境的推送证书）。
  • Background Modes中必须勾选Remote notifications，后台推送依赖该权限。

二、Firebase集成排查 #

• 验证GoogleService-Info.plist有效性：
  确保文件是从Firebase控制台对应白标iOS应用下载，Bundle ID与项目完全匹配（大小写、空格一致），且已添加到Xcode项目的Copy Bundle Resources构建阶段中。
• 检查Firebase控制台配置：
  • 已上传对应环境（开发/生产）的iOS推送证书到Firebase Cloud Messaging（FCM）模块。
  • 发送测试推送时，确认选择了正确的应用和环境（开发环境选Sandbox，生产环境选Production）。

三、Rocket.chat特定配置检查 #

• 服务器端推送配置验证：
  确认Rocket.chat服务器已正确配置FCM服务，使用的是白标应用对应的Firebase服务器密钥，且服务器能正确转发iOS设备的APNs令牌到FCM。
• 应用内推送注册逻辑检查：
  在Xcode控制台搜索APNs token或FCM token关键词，确认应用启动时成功获取设备令牌并提交到服务器，无注册失败的错误日志。

四、测试环境注意事项 #

• iOS模拟器不支持APNs推送，必须使用真实iOS设备测试通知功能。
• 真实设备需关闭“专注模式”“请勿打扰”，确保网络正常，避免系统拦截通知。

五、日志排查 #

• 连接真实设备到Xcode，过滤PushKit、FirebaseMessaging、RocketChat相关日志：
  • 查看是否存在令牌获取失败、服务器提交令牌失败的错误信息。
  • 发送测试推送后，检查是否有FCM消息到达但被应用内部拦截的记录。
• 通过Firebase控制台发送测试消息，同步观察设备日志，确认消息是否正常到达设备。

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