集成react-native-marketingcloudsdk遇异常：Android收不到后台通知，iOS崩溃

Android端：后台/退出状态无通知、监听器无响应 #

• 推送通道配置检查
  • 确认已完成Firebase Cloud Messaging（FCM）集成：google-services.json需正确放置在android/app目录，android/build.gradle和android/app/build.gradle中已添加FCM相关依赖配置。
  • 验证Marketing Cloud后台的FCM服务器密钥：确保控制台移动应用设置中的密钥与Firebase项目内的服务器密钥完全一致。
• 通知权限与渠道设置
  • Android 8.0+必须创建通知渠道：在MainApplication的onCreate方法中调用MarketingCloudSdk.createNotificationChannel()，且渠道ID需与Marketing Cloud推送配置的渠道ID匹配。
  • Android 13+需动态申请POST_NOTIFICATIONS权限：在应用启动或合适时机添加权限申请逻辑，确保用户授予通知权限。
• 监听器注册逻辑
  • 确保监听器在应用启动时就完成注册：比如在App.js的useEffect（无依赖项）中调用addNotificationReceivedListener和addNotificationOpenedListener，避免注册逻辑被条件分支拦截。
  • 检查监听器回调代码：确保回调内无未捕获的异常，防止因代码错误导致监听器失效。
• 推送Payload格式验证
  后台推送需包含data字段：Marketing Cloud发送的推送不能仅包含notification字段，否则后台/退出状态下无法触发自定义监听器，需确保Payload符合FCM规范。

iOS端：编译成功后应用崩溃 #

从错误截图的类未找到问题，按以下步骤排查：

• Pod依赖重装
  进入ios目录，依次执行：

  pod deintegrate
  pod install --repo-update
  

  确保Podfile中已正确添加：

  pod 'react-native-marketingcloudsdk', :path => '../node_modules/react-native-marketingcloudsdk'
  

• Xcode Capabilities配置
  • 打开项目的Signing & Capabilities面板，添加Push Notifications能力。
  • 添加Background Modes能力并勾选Remote notifications选项。
• APNs与初始化配置
  • 确认Apple开发者后台已生成并配置正确的APNs证书（开发/生产环境需匹配），且已上传至Marketing Cloud控制台。
  • 检查AppDelegate中的SDK初始化逻辑：在didFinishLaunchingWithOptions方法中正确调用MarketingCloudSDK.configure()，确保传入的appId、accessToken等参数准确。
• 版本兼容性调整
  react-native-marketingcloudsdk@8.0.0与RN 0.68.2可能存在兼容问题，可尝试降级至7.x.x版本，重新安装依赖后测试是否解决崩溃。

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