Firebase推送通知异常求助：聊天室通知失效问题

1. 核查云函数服务账号权限 #

• 确认云函数绑定的服务账号是否拥有firebase.messaging.send权限，或者直接给它加Cloud Messaging Admin角色。哪怕没主动改权限，后台偶尔可能出现权限同步异常。
• 拉取云函数的完整日志，除了'unknown server'，找有没有更具体的错误细节——比如认证失败、请求超时这类被掩盖的信息。

2. 核对FCM请求格式 #

• 把云函数里的推送请求和Firebase控制台发送的请求做对比：
  • 确认目标设备token没问题（多设备都出问题，大概率不是单个token失效，但还是要排除批量token过期的可能）。
  • 检查payload结构：Android的notification和data字段有没有符合FCM规范，iOS的aps字段配置是否正确，比如是否包含alert、sound这些必要项。
  • 确认请求里的priority设置，高优先级(high)才能确保即时推送，低优先级容易被系统压后。

3. 检查云函数网络连通性 #

• 'unknown server'很大概率是云函数连不上FCM服务器：
  • 确认云函数所在区域能正常访问https://fcm.googleapis.com/fcm/send，部分区域可能有网络访问限制。
  • 如果用了VPC或防火墙规则，检查是否允许出站请求到FCM的域名和443端口。

4. 升级FCM SDK并检查依赖 #

• 看看云函数里用的firebase-admin SDK是不是版本太老，旧版本可能和FCM服务器存在兼容性问题，直接升级到最新稳定版试试。
• 排查依赖冲突，比如其他第三方SDK可能干扰了FCM的请求发送逻辑。

5. 编写极简测试函数验证 #

• 写一个只包含基础FCM推送逻辑的测试云函数，用已知有效的设备token测试。如果测试函数能成功发通知，说明原函数的业务逻辑里有问题；如果也失败，就把重点放在环境配置上。

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