FCM迁移至HTTP v1后设备组管理出现401未授权问题排查

问题背景 #

正在将FCM从Legacy API迁移至HTTP v1 API，已创建firebase-adminsdk服务账号，可通过服务账号生成的JWT令牌调用v1 API向单设备推送通知，但调用旧设备组管理API（/fcm/notification）时，即使替换为JWT令牌仍返回401未授权错误。

核心原因 #

旧设备组API（/fcm/notification）仅兼容Legacy服务器密钥，不支持服务账号生成的JWT令牌授权；同时FCM HTTP v1 API无直接对应的设备组管理接口，需通过Firebase Admin SDK或主题订阅替代。

解决方案 #

1. 使用Firebase Admin SDK管理设备组 #

直接通过Admin SDK处理设备组操作，SDK会自动完成授权和API调用，避免手动处理JWT的兼容性问题：

const admin = require('firebase-admin');
admin.initializeApp({
  credential: admin.credential.applicationDefault()
});

// 创建设备组
admin.messaging().createDeviceGroup({
  notificationKeyName: 'test-group',
  registrationTokens: ['devicetokenidhere1', 'devicetokenidhere2']
})
.then((response) => {
  console.log('设备组创建成功，notificationKey:', response.notificationKey);
})
.catch((error) => {
  console.error('设备组创建失败:', error);
});

• 支持创建、更新、删除设备组操作，完全兼容服务账号权限。

2. 替代方案：改用FCM主题订阅 #

若设备组的核心需求是批量推送通知，推荐使用主题订阅（HTTP v1 API原生支持）：

• 让目标设备订阅同一主题（如test-group）
• 推送时直接向主题发送消息，无需管理设备组密钥：

// 向主题推送通知
admin.messaging().sendToTopic('test-group', {
  notification: {
    title: '测试通知',
    body: '主题推送消息内容'
  }
});

• 支持动态添加/移除订阅设备，无需依赖即将停用的Legacy接口。

3. 权限检查（若坚持HTTP API调用） #

若必须直接调用HTTP接口，需确保服务账号配置正确权限：

• 为服务账号分配Firebase Cloud Messaging Admin角色（roles/firebase.messagingAdmin）
• 在Google Cloud IAM控制台确认角色已生效

验证方法 #

• 使用Admin SDK生成设备组密钥后，通过HTTP v1 API向该密钥推送消息，确认送达正常。
• 测试主题订阅推送，验证所有订阅设备均可收到通知。

内容的提问来源于stack exchange，提问作者Byron Wang