在Google Cloud函数中使用FCM遇SenderID不匹配问题求助

核心问题排查与解决方案 #

1. 确认服务账号与Firebase项目的绑定关系 #

云函数使用的服务账号必须属于目标Firebase项目绑定的GCP项目。SenderId是Firebase项目的唯一标识，如果服务账号所属GCP项目和FCM消息对应的Firebase项目不一致，必然触发该错误。

• 操作步骤：进入GCP控制台IAM页面，找到云函数的运行服务账号，查看其所属项目，确认与Firebase控制台显示的关联GCP项目完全一致。

2. 验证IAM权限的有效性 #

虽然添加了Firebase Admin角色，仍需确认权限是否覆盖FCM发送需求：

• 优先推荐为服务账号添加Cloud Messaging Admin角色（该角色专门包含FCM发送的所有必要权限），而非泛用的Firebase Admin角色，避免权限冗余或未同步问题。
• 若需精细化权限，直接添加firebase.messaging.send权限即可。

3. 云函数中加载服务账号JSON文件的正确实现 #

如果ADC自动初始化方式无效，可以沿用JSON文件初始化，云函数部署时会打包本地资源文件，可通过类路径读取：

// 将服务账号JSON文件放在src/main/resources目录下（Java项目结构）
InputStream serviceAccount = getClass().getResourceAsStream("/myproj-firebase-adminsdk-xyzabc.json");

FirebaseOptions options = new FirebaseOptions.Builder()
    .setCredentials(GoogleCredentials.fromStream(serviceAccount))
    .build();

// 避免重复初始化FirebaseApp
if (FirebaseApp.getApps().isEmpty()) {
    FirebaseApp.initializeApp(options);
}

• 部署注意：确保构建工具（Maven/Gradle）配置中包含资源文件打包规则，比如Maven的resources插件要将src/main/resources下的文件打包到部署包中。

4. 检查FCM消息的目标合法性 #

确认发送消息的目标设备token是注册到当前Firebase项目的，若设备属于其他Firebase项目，同样会触发SenderId不匹配错误。

内容的提问来源于stack exchange，提问作者Mike Dee