Xamarin Forms项目遇com.google.gms:google-services初始化错误求助

架构老林

2026-7-28

解决Xamarin Forms项目中莫名出现的Firebase/gradle初始化错误

问题背景

更新Visual Studio for Mac后，未主动引入任何Firebase或gradle相关内容的Xamarin Forms项目，突然弹出以下初始化错误：

[FirebaseApp] Default FirebaseApp failed to initialize because no default options were found. This usually means that com.google.gms:google-services was not applied to your gradle project. 
[FirebaseInitProvider] FirebaseApp initialization unsuccessful

此前项目正常运行数月，尝试过更新VS、重装VS、安装卸载相关NuGet包均无效，重装VS后正常数小时问题复发。

解决方案

1. 排查隐性依赖

打开Android工程的「管理NuGet程序包」，切换到「已安装」标签，逐一检查是否有间接依赖Firebase的第三方包（如广告、统计类SDK常默认引入Firebase组件）
利用NuGet的「依赖关系」视图，追踪每个包的依赖树，定位引入Firebase的源头，考虑替换或移除该包

2. 清理构建缓存与文件

关闭Visual Studio for Mac
删除Android工程下的bin、obj文件夹
删除用户目录下的gradle缓存（路径：~/.gradle/caches）
重新打开项目，执行「清理解决方案」后再重新构建

3. 强制移除Firebase初始化Provider

如果确认项目不需要Firebase服务，可手动禁用其初始化：

打开Android工程的AndroidManifest.xml，在根manifest标签添加工具命名空间：
```
xmlns:tools="http://schemas.android.com/tools"
```

添加以下代码强制移除Firebase初始化Provider：

<provider
    android:name="com.google.firebase.provider.FirebaseInitProvider"
    android:authorities="${applicationId}.firebaseinitprovider"
    tools:node="remove" />