FCM服务器密钥获取指南

最近更新 2026/10/03

获取FCM服务器私钥

警告

FCM 通道支持两种服务器密钥配置方式，这里我们支持的是最新的。2020 年 3 月开始，FCM 已停止创建旧服务器密钥。如果未开启最新的 Firebase Cloud Messaging API (V1)，可以在右侧进入Google Cloud Console中管理API进行启用。如果您是 Cloud Messaging API（旧版）的现有用户，请考虑迁移到最新的 Firebase Cloud Messaging API (V1)了解详情 。

• 访问 Firebase工作台 并登录账号
• 在 Firebase 项目 —> 选择项目应用 —> 项目设置 —> 服务账号中，单击生成新的私钥，获取到 Firebase 服务器私钥 json 文件。

• 此外，还可以在云消息传递中点击管理服务账号，在项目服务账号列表中点击管理密钥，再点击添加密钥。

FCM通道测试

配置完成FCM通道后，可以直接在通道设置中进行通道的效果测试，点击对应通道后面的操作列 发送测试 按钮（见下图指示）即可进入通道测试。

在发送测试时，需要填写用于验收效果的测试账号对应的发送ID（可以使用 AE 的 用户细查 功能查询测试账号的FCM registration token）以及消息通知的 标题、内容等信息。点击确认发送后，即可在手机上查看对应效果。

注意事项

• FCM通道的发送ID一定要选择代表 FCM registration token 的用户属性，也就是我们需要在接入使用前上报该属性作为用户属性方可正常使用。

• 在进行测试时，发送ID也需要选择测试账号对应的 FCM registration token 用户属性，否则将出现发送ID不可用的报错。

• 建议使用海外发售的Android真机进行测试

  • 测试设备必须使用真机，模拟器收不到消息通知
  • 测试设备必须支持 Google GMS 服务（Google Mobile Services）

• 建议在海外网络环境进行测试

  • 如果在中国大陆地区进行测试，要求测试设备尽量乃至必须使用海外 IP 地址
  • 测试设备所处的网络环境必须可以正常访问 Google 网络服务，否则即使触发 FCM 推送，该设备也无法从 FCM 通道收取推送