Web端Firebase Cloud Messaging：通过Postman发送消息

嘿，恭喜你已经搞定了Web端FCM的初始化和设备Token获取！接下来用Postman发送FCM消息其实一点都不难，我给你一步步捋清楚：

第一步：获取FCM服务器密钥 #

首先得拿到鉴权用的服务器密钥，步骤如下：

• 打开Firebase控制台，找到你的项目
• 进入「项目设置」→ 切换到「云消息传递」标签页
• 找到「服务器密钥」并复制（注意别选错成Web推送证书，就是那个长串的密钥）

第二步：配置Postman请求 #

基础请求配置 #

• 请求方法：选择 POST
• 请求URL：填入 https://fcm.googleapis.com/fcm/send

设置请求头 #

需要添加两个必填的请求头：

• Authorization: 格式为 key=你的服务器密钥（密钥直接跟在key=后面，别加空格）
• Content-Type: 设置为 application/json

编写请求体（JSON格式） #

根据你要发送的消息类型，选对应的请求体模板：

1. 发送通知消息（会直接在浏览器通知栏弹出）

{
  "to": "你的Web设备Token",
  "notification": {
    "title": "测试通知标题",
    "body": "这是一条来自Postman的FCM测试通知",
    "icon": "/your-app-icon.png" // 可选，自定义通知图标
  },
  "webpush": {
    "headers": {
      "Urgency": "high" // 可选，设置高优先级，确保通知及时送达
    }
  }
}

2. 发送数据消息（不会自动弹出，需前端代码处理）

适合需要自定义逻辑的场景，比如静默更新数据：

{
  "to": "你的Web设备Token",
  "data": {
    "customKey": "自定义内容",
    "targetPage": "/user-center"
  }
}

3. 同时发送通知+数据消息

既弹出通知，又携带自定义数据，点击通知还能跳转指定链接：

{
  "to": "你的Web设备Token",
  "notification": {
    "title": "新消息提醒",
    "body": "你有一条待处理的订单"
  },
  "data": {
    "orderId": "10086"
  },
  "webpush": {
    "fcm_options": {
      "link": "https://your-app.com/orders/10086"
    }
  }
}

第三步：发送请求并验证 #

• 把所有配置填好后，点击Postman的「Send」按钮
• 成功的话，会收到类似这样的响应：

{
  "multicast_id": 1234567890123,
  "success": 1,
  "failure": 0,
  "canonical_ids": 0,
  "results": [
    {
      "message_id": "0:1234567890abcdef%abc123def456abc"
    }
  ]
}

• 同时你的Web端应该能收到通知，或者在Service Worker的onMessage事件中拿到数据（如果是数据消息的话）

常见问题排查 #

• 收到InvalidRegistration错误：检查设备Token是否正确，Web端Token可能会刷新，确保用的是最新的
• 收到Unauthorized错误：核对服务器密钥是否复制正确，有没有权限问题
• 通知没弹出：确认浏览器已经允许通知权限，并且你的Service Worker已经正确注册（FCM Web端必须依赖Service Worker）

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