如何用Node.js向所有Android设备发送FCM通知？解决必填参数错误

你遇到的错误Exactly one of topic, token or condition is required，是因为Firebase Cloud Messaging（FCM）的规则里，发送通知必须明确指定接收目标——要么是单个设备的token，要么是主题订阅组，要么是条件表达式，没有直接"无条件发给所有用户"的原生API。

要实现给所有用户发通知，最简便的方案是让所有客户端订阅一个共享主题（比如all_app_users），然后后端针对这个主题发送通知就行。下面分两步具体实现：

第一步：在Ionic Android客户端自动订阅主题 #

首先你的Ionic应用需要集成FCM相关插件（比如@capacitor/fcm或者cordova-plugin-fcm-with-dependecy-updated），然后在应用启动时自动完成主题订阅，确保所有用户都能加入这个通知组。示例代码如下：

// Ionic/Angular 示例（基于Capacitor FCM）
import { FCM } from '@capacitor/fcm';

async function subscribeToGlobalTopic() {
  try {
    await FCM.subscribeToTopic({ topic: 'all_app_users' });
    console.log('已成功订阅全量通知主题');
  } catch (error) {
    console.error('订阅主题失败:', error);
  }
}

// 在应用初始化时调用，比如app.component.ts的ngOnInit生命周期里
ngOnInit() {
  subscribeToGlobalTopic();
}

这样新用户安装应用后会自动加入主题组，老用户只要启动应用也会完成订阅，不会遗漏。

第二步：Node.js后端发送主题通知 #

修改你现有的Node.js代码，在消息配置里指定目标主题为all_app_users，就能给所有订阅该主题的用户发送通知了：

var admin = require("firebase-admin");
var serviceAccount = require("/path/to/config.json");

admin.initializeApp({
  credential: admin.credential.cert(serviceAccount),
  databaseURL: "https://myApp.firebaseio.com"
});

var message = {
  notification: {
    title: '$GOOG up 1.43% on the day',
    body: '$GOOG gained 11.80 points to close at 835.67, up 1.43% on the day.'
  },
  topic: 'all_app_users' // 这里指定共享主题
};

admin.messaging().send(message)
  .then((response) => {
    console.log('通知发送成功:', response);
  })
  .catch((error) => {
    console.log('发送失败:', error);
  });

额外提示 #

如果你的应用已经有大量存量用户，建议通过FCM的批量主题管理API，把现有设备token批量添加到all_app_users主题里，避免老用户收不到通知。主题订阅是免费的，FCM对主题消息的发送量限制也很宽松，完全适合全量通知的场景。

内容的提问来源于stack exchange，提问作者Santosh Hegde