Ionic项目Android运行报错：FirebaseInitProvider参数非法异常

嘿，这个FCM初始化导致的崩溃问题我之前也碰到过，核心报错java.lang.IllegalArgumentException: Given String is empty or null指向FirebaseInitProvider，说明Firebase初始化时找不到有效的配置信息，给你几个针对性的解决步骤：

• 检查google-services.json的位置与有效性
  首先确认你从Firebase控制台下载的google-services.json文件已经正确放置：

  • 如果你用的是Cordova，文件要放在platforms/android/app/目录下；
  • 如果你用的是Capacitor，文件要放在android/app/src/main/目录下；
    打开文件检查api_key、project_id、client节点下的client_id等关键字段，确保没有空值，而且这个文件是对应你当前项目（包名com.app.name）的，不能用错其他项目的配置文件。

• 验证FCM插件的配置与同步
  如果你用的是Cordova插件（比如cordova-plugin-firebase），执行以下命令确保配置同步：

  ionic cordova prepare android
  

  要是用的Capacitor的推送插件（@capacitor/push-notifications），则运行：

  npx cap sync android
  

  同时确认config.xml（Cordova）或capacitor.config.ts（Capacitor）里的包名和Firebase控制台添加的Android应用包名完全一致，大小写都不能差。

• 清理缓存并重新构建
  缓存可能导致配置不生效，先清理Android项目的构建缓存：
  进入项目的android目录，运行：

  # macOS/Linux
  ./gradlew clean
  # Windows
  gradlew clean
  

  然后重新构建Ionic项目：

  # Cordova
  ionic build && ionic cordova build android --prod
  # Capacitor
  ionic build && npx cap build android
  

• 检查AndroidManifest.xml的配置
  虽然插件通常会自动添加，但可以确认android/app/src/main/AndroidManifest.xml里是否存在FirebaseInitProvider的配置节点：

  <provider
      android:name="com.google.firebase.provider.FirebaseInitProvider"
      android:authorities="${applicationId}.firebaseinitprovider"
      android:exported="false"
      android:initOrder="100" />
  

  确保${applicationId}能正确替换成你的包名com.app.name，如果手动修改过包名，可能需要手动调整这个配置。

小提示：如果是第一次配置FCM，一定要在Firebase控制台里准确添加包名为com.app.name的Android应用，下载配置文件后再进行项目构建，避免包名不匹配导致的配置失效。

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