Firebase通知重复问题求助：同一设备生成多有效注册令牌

我之前也碰到过一模一样的问题——同一用户在相同桌面设备、同一网络域下生成了一大堆Firebase注册令牌，每个令牌都能正常接收推送，结果就是用户收到N条重复通知。折腾了好一阵，总结出几个核心的解决思路：

先搞清楚为啥会生成多令牌 #

这种情况通常逃不出这几个原因：

• 前端每次页面加载都直接调用getToken()，没先检查有没有现成的有效令牌，导致重复注册
• 浏览器缓存被频繁清理，Firebase没法保留之前的令牌记录，每次都重新生成
• 没处理令牌更新的逻辑，旧令牌过期后没有被标记无效，新令牌又加进来，堆了一堆
• 同一设备的多个浏览器标签页重复触发注册流程，每个标签页都生成一个令牌

一步步解决问题 #

1. 先检查再注册，别上来就生成新令牌 #

在调用getToken()之前，先尝试获取现有令牌，如果有就直接复用，别瞎生成新的：

firebase.messaging().getToken({ vapidKey: '你的VAPID_KEY' })
  .then((currentToken) => {
    if (currentToken) {
      // 直接把现有令牌发给后端存着就行
      sendTokenToServer(currentToken);
    } else {
      // 真没令牌的时候再去请求权限注册
      requestNotificationPermission();
    }
  })
  .catch((err) => {
    console.error('获取令牌出错:', err);
  });

2. 监听令牌更新，及时替换旧令牌 #

Firebase会在令牌过期或者需要更新的时候触发onTokenRefresh事件，这时候一定要把新令牌同步到后端，同时把旧令牌删掉，不然旧令牌还能收到推送：

firebase.messaging().onTokenRefresh(() => {
  firebase.messaging().getToken({ vapidKey: '你的VAPID_KEY' })
    .then((refreshedToken) => {
      console.log('令牌更新了:', refreshedToken);
      // 告诉后端用新令牌替换旧的
      updateTokenInBackend(refreshedToken);
    })
    .catch((err) => {
      console.error('刷新令牌失败:', err);
    });
});

3. 后端要做好令牌的去重和清理 #

后端存储令牌的时候得加一层逻辑：

• 给每个用户+设备（可以用浏览器指纹、设备标识之类的辅助字段）绑定唯一的有效令牌，新令牌进来就自动覆盖旧的
• 定期验证令牌有效性，比如用Firebase Admin SDK发个测试消息，把无效的令牌删掉
• 别啥令牌都存，同一用户同一设备只留最新的那个就行

4. 前端注册逻辑要优化 #

• 别每次页面加载都触发注册，用本地存储个标记，比如localStorage.setItem('fcmRegistered', 'true')，已经注册过就跳过
• 用户拒绝通知权限后，别反复弹请求，体验太差还容易重复触发注册
• 单页应用里，只在首次加载或者用户变更权限的时候执行注册流程

临时救急：清理已有的重复令牌 #

如果已经堆了一堆重复令牌，可以用Firebase Admin SDK批量删掉冗余的：

const admin = require('firebase-admin');
admin.initializeApp();

// 假设你拿到了某个用户的所有重复令牌
const redundantTokens = ['token1', 'token2', '...'];
admin.messaging().deleteTokens(redundantTokens)
  .then((result) => {
    console.log('成功删除了', result.successCount, '个无效令牌');
  })
  .catch((err) => {
    console.error('删除令牌出错:', err);
  });

内容的提问来源于stack exchange，提问作者wai yu