Firebase JS SDK 中 messaging.usePublicVapidKey 方法废弃后的替代方案

背景介绍

Firebase Cloud Messaging (FCM) 是一个流行的跨平台消息传递解决方案，允许开发者向客户端应用发送通知和消息。在 Firebase JS SDK 的早期版本中，开发者可以使用 messaging.usePublicVapidKey() 方法来设置 Web 推送通知的 VAPID 密钥。

关键变更

在 Firebase JS SDK 10.13.1 版本中，usePublicVapidKey 方法已被标记为废弃。这一变更影响了那些直接在客户端代码中使用此方法的开发者。VAPID (Voluntary Application Server Identification) 密钥对于 Web 推送通知的身份验证至关重要，它确保了消息的来源可信。

新版本中的替代方案

在新的 SDK 版本中，开发者需要在获取设备令牌时直接传递 VAPID 密钥，而不是单独设置。以下是核心变更点：

1. 移除旧方法：不再需要调用 messaging.usePublicVapidKey('MYKEY')

2. 新参数传递方式：在 getToken 方法中直接传递 VAPID 密钥

messaging.getToken({ 
  vapidKey: 'YOUR_VAPID_KEY_HERE' 
}).then((currentToken) => {
  // 处理令牌
});

完整实现示例

初始化 Firebase

// 使用兼容版本SDK
importScripts('firebase-app-compat.js');
importScripts('firebase-messaging-compat.js');

const firebaseConfig = {
  apiKey: "YOUR_API_KEY",
  authDomain: "YOUR_AUTH_DOMAIN",
  projectId: "YOUR_PROJECT_ID",
  // 其他配置项
};

firebase.initializeApp(firebaseConfig);
const messaging = firebase.messaging();

处理后台消息

messaging.setBackgroundMessageHandler((payload) => {
  const notificationTitle = payload.notification.title;
  const notificationOptions = {
    body: payload.notification.body,
    icon: 'path/to/icon.png'
  };
  
  return self.registration.showNotification(
    notificationTitle,
    notificationOptions
  );
});

获取设备令牌

Notification.requestPermission().then((permission) => {
  if (permission === 'granted') {
    messaging.getToken({ vapidKey: 'YOUR_VAPID_KEY' })
      .then((currentToken) => {
        if (currentToken) {
          // 将令牌发送到服务器
        } else {
          console.warn('无法获取FCM令牌');
        }
      })
      .catch((err) => {
        console.error('获取令牌时出错', err);
      });
  }
});

服务器端调整

随着客户端SDK的变更，服务器端也需要相应调整：

1. 认证方式变更：从简单的API密钥认证改为OAuth 2.0认证
2. 需要生成服务账户密钥：从Firebase控制台下载JSON凭证文件
3. HTTP API版本：必须使用v1版本的API端点

常见问题解决

1. firebase未定义错误：确保正确引入了Firebase SDK的兼容版本
2. 方法不存在错误：检查SDK版本是否过旧或使用了错误的引入方式
3. 权限问题：确保已正确处理通知权限请求流程

总结

Firebase JS SDK 的这一变更使得VAPID密钥的管理更加集中和安全。虽然需要开发者对现有代码进行调整，但新的实现方式更加符合现代Web开发的最佳实践。开发者应当及时更新代码，以确保推送通知功能的持续可用性。

对于从旧版本迁移的开发者，建议全面测试通知的接收和显示功能，特别是在不同浏览器和设备上的表现，以确保平滑过渡。