Expo集成react-native-firebase/messaging调用getToken报Firebase模块未安装错误

开发者阿泽

2026-10-6

排查解决步骤

确认你当前运行的不是Expo Go官方客户端：原生react-native-firebase全系列库都不支持Expo Go，必须使用EAS编译的自定义开发构建才能运行
检查依赖是否完整安装：必须同时安装@react-native-firebase/app核心包和@react-native-firebase/messaging功能包，仅安装messaging包会触发核心模块缺失报错
执行以下命令确认安装：
```
npm install @react-native-firebase/app @react-native-firebase/messaging
# 或者用yarn
yarn add @react-native-firebase/app @react-native-firebase/messaging
```

检查app.json的plugins配置是否完整，你提供的配置中缺少了react-native-firebase对应的插件声明，需要在app.json的根节点下添加如下配置：

"plugins": [
  "@react-native-firebase/app",
  "@react-native-firebase/messaging",
  [
    "expo-build-properties",
    {
      "android": {
        "compileSdkVersion": 33,
        "targetSdkVersion": 33,
        "buildToolsVersion": "33.0.0"
      },
      "ios": {
        "useFrameworks": "static"
      }
    }
  ]
]

确认你项目根目录下的google-services.json文件路径和app.json中android.googleServicesFile配置的路径一致，且文件内的package_name值和你app.json中配置的android.package值完全匹配
所有原生相关配置修改完成后，必须重新执行EAS开发构建命令生成新的安装包，热更新/刷新JS不会生效原生配置修改
如果你使用的是Expo裸工作流，才需要按照报错提示手动修改MainApplication.java文件添加对应包引用，Expo托管工作流不需要手动修改原生文件，插件会自动完成对应配置