Expo托管React Native应用部署后推送通知失败排查

核心问题分析 #

部署后的应用无法初始化Firebase App，导致推送令牌获取失败，这通常是Expo托管工作流中Firebase配置未正确关联到构建包的问题，而非本地代码或文件放置错误。

具体修复步骤 #

1. 确认Expo Firebase配置的完整性 #

• 检查Expo控制台项目的Credentials > Firebase板块：
  • 确保上传的google-services.json与构建包的包名com.teologi.newMotivationalExerciseApp完全匹配
  • 服务账号密钥必须是Firebase项目设置 > 服务账号中生成的JSON文件，且拥有Cloud Messaging权限
• 执行命令expo fetch:android:google-services，拉取Expo控制台存储的配置覆盖本地文件，避免本地与云端配置不一致

2. 检查构建配置与环境变量 #

• 若使用环境变量存储Firebase密钥，需在Expo控制台Secrets中添加对应变量，确保构建过程能读取到
• 对于EAS Build，检查eas.json的构建配置，确保Android部分启用Firebase集成：

  {
    "build": {
      "production": {
        "android": {
          "googleServicesFile": "./google-services.json"
        }
      }
    }
  }
  

3. 显式初始化Firebase #

在应用启动入口（如App.js顶部）添加显式初始化代码，避免依赖自动初始化：

import { initializeApp } from 'firebase/app';
import { getMessaging } from 'firebase/messaging';

const firebaseConfig = {
  apiKey: "你的API密钥",
  authDomain: "你的Auth域名",
  projectId: "你的项目ID",
  storageBucket: "你的存储桶地址",
  messagingSenderId: "你的发送者ID",
  appId: "你的App ID"
};

// 显式初始化Firebase App
const app = initializeApp(firebaseConfig);
const messaging = getMessaging(app);

确保调用getDevicePushTokenAsync前，Firebase App已完成初始化，可通过启动加载逻辑或用户登录状态回调延迟推送权限请求。

4. 清理缓存并重新构建 #

• 清除Expo本地缓存：expo r -c
• 清除EAS构建缓存：eas build --clear-cache
• 重新触发构建，确保新配置被打包进应用

5. 验证包名一致性 #

• 确认Firebase控制台注册的Android应用包名com.teologi.newMotivationalExerciseApp与app.json中android.package完全一致，包括大小写和特殊字符
• 若包名曾修改，需在Firebase控制台重新注册对应包名的应用，下载新的google-services.json上传到Expo

额外排查点 #

• 检查Firebase控制台Cloud Messaging板块，确认Android服务器密钥和发送者ID配置正确
• 用APK分析工具查看构建后的安装包，检查res/values/google-services.xml是否存在正确的配置参数

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