Firebase Cloud Messaging添加异常:已配置google-services仍无法完成配置
解决FCM未成功添加的排查与手动配置方法
一、先检查核心配置项
- 模块级build.gradle配置:除了项目根目录的gradle配置,必须在app模块的
build.gradle末尾添加插件引用,同时引入FCM依赖:// 放在文件末尾 apply plugin: 'com.google.gms.google-services' dependencies { // FCM核心依赖(建议使用最新稳定版) implementation 'com.google.firebase:firebase-messaging:23.4.0' } - google-services.json文件:确认这个从Firebase控制台下载的文件,已经放在app模块的根目录下,且文件里的包名和你应用的包名完全一致。
- 同步与构建验证:点击Android Studio右上角的
Sync Project with Gradle Files,同步完成后执行Build > Clean Project再Rebuild Project,查看Gradle控制台是否有报错信息。
二、手动验证FCM是否生效
在Application类或启动Activity中添加令牌获取代码,验证FCM是否实际工作:
// Kotlin示例 FirebaseMessaging.getInstance().token.addOnCompleteListener { task -> if (!task.isSuccessful) { Log.w("FCM_DEBUG", "获取令牌失败", task.exception) return@addOnCompleteListener } val token = task.result Log.d("FCM_DEBUG", "FCM令牌: $token") }
如果能成功打印令牌,说明FCM已经正常配置,控制台按钮未更新大概率是控制台缓存或延迟问题,刷新页面即可。
三、排查控制台状态异常
- 清除浏览器缓存或换用其他浏览器打开Firebase控制台,避免控制台状态更新延迟。
- 确认控制台选择的项目和应用与本地项目完全匹配,防止选错关联目标导致状态不更新。
- 进入Firebase控制台的
项目设置 > 云消息传递页面,检查服务器密钥等配置是否存在,可侧面验证FCM关联状态。
内容的提问来源于stack exchange,提问作者Anton Kononenko
相关产品推荐
相关产品推荐

