React Native应用部署后Android提示频繁崩溃，FCM通知失效求调试方案

1. 抓取Android系统日志定位隐性崩溃 #

• 连接设备到电脑，执行adb logcat命令，用过滤规则缩小范围：
  • 只看错误级日志：adb logcat *:E
  • 精准过滤FCM和应用进程：adb logcat -s FirebaseMessaging Crashlytics com.your.app.package
• 重点盯AndroidRuntime、Crash、ANR（应用无响应）相关条目——系统提示的“频繁崩溃”大概率是后台进程崩溃或ANR，前台没直观感知
• 关注FCM消息接收瞬间的日志，排查FirebaseMessagingService是否有异常，比如权限缺失、消息解析失败

2. 校验FCM基础配置与权限 #

• 检查AndroidManifest.xml：确认FirebaseMessagingService子类已正确注册，Android 13+需声明并请求android.permission.POST_NOTIFICATIONS权限
• 核对android/app下的google-services.json，确保包名和后台发送通知的目标包名完全一致
• 换发数据消息测试：通知消息由系统处理，数据消息由应用接管，能快速区分是系统层还是应用层问题

3. 排查系统电池优化与后台限制 #

• 系统弹出深度睡眠提示，说明应用已被电池优化策略标记为异常
• 进入设备设置→电池→电池优化，找到你的应用，手动设置为“不优化”后再测通知
• 针对国产ROM（小米、华为等），检查后台启动权限，手动开启“允许后台启动”——这类ROM的后台限制会直接阻断FCM推送

4. 排查React Native FCM库的代码问题 #

• 确认@react-native-firebase/messaging等依赖库版本和React Native版本兼容，尝试升级到最新稳定版
• 检查setBackgroundMessageHandler的实现：后台消息处理时的未捕获异常会导致后台进程崩溃，前台完全没反应
• 暂时移除自定义通知逻辑，用FCM默认通知测试，排除代码逻辑干扰

5. 用崩溃追踪工具抓后台崩溃 #

• 集成Crashlytics到应用，后台进程的崩溃会被自动捕获并生成详细堆栈
• 登录Crashlytics后台，筛选“后台线程”或“FCM相关”的崩溃记录，定位具体代码问题

6. 模拟真实场景复现问题 #

• 让应用完全进入后台（甚至杀掉前台进程），再发送FCM通知，观察Logcat和系统提示
• 测试不同Android版本的设备，确认是否是特定系统版本的兼容问题

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