使用Firebase Cloud Messaging推送消息时遇「请求含无效参数」错误

一、无效参数错误的可能原因 #

1. Token无效是大概率原因 #

没错，无效token确实会触发这个模糊的错误。FCM token一旦过期、被用户注销（比如卸载APP/清除浏览器推送权限）、或者格式不对，都会返回这类参数错误。可以这么验证：

• 调用客户端的getToken()重新获取该用户的token，替换后重试
• 去Firebase控制台的「Cloud Messaging」面板，查看是否有该token的失效记录

2. 请求JSON的格式问题 #

你的请求同时包含了notification和webpush.notification字段，虽然FCM支持，但偶尔会出现冲突。另外，RFC8030的标准和FCM的Web Push实现有细节差异：

• FCM要求webpush.headers.TTL必须是整数类型（不能加引号），你之前试过但可以再确认下格式是否正确
• Topic字段不能放在webpush.headers里，FCM的Web Push headers不支持自定义Topic，正确做法是把"topic": "tpPlanningNoticeLessThenXTime"移到JSON根层级

修正后的请求示例：

{
  "notification": {
    "title": "15:06: Change in planning",
    "body": "There has been a change in your planning today.",
    "image": "https://my-site/logo.jpg"
  },
  "webpush": {
    "notification": {
      "title": "15:06: Change in planning",
      "body": "There has been a change in your planning today.",
      "icon": "https://my-site/logo.jpg"
    },
    "headers": {
      "Urgency": "high",
      "TTL": 86400
    }
  },
  "token": "__a_163_character_token_here__",
  "topic": "tpPlanningNoticeLessThenXTime"
}

二、FCM的测试方案 #

FCM没有独立的沙箱环境，但可以用这些方式做测试：

• 使用Firebase的测试设备组：在控制台添加测试设备的token，专门用来测试推送，不影响生产用户
• 开启客户端调试模式：Web/APP初始化FCM时打开调试日志，能看到token生成、注册的详细过程，以及接收推送时的错误信息
• 用Postman或curl直接调用FCM API，配合测试token验证请求格式是否正确

额外提示 #

如果以上方法都无效，去Firebase控制台的「Analytics」或「Logging」面板查看FCM的错误日志，里面会有更具体的错误原因，比如明确指出哪个参数无效，比模糊的「invalid argument」有用多了。

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