刚完成GCM到FCM的迁移，正好碰到过这两个问题，给你梳理一下解决方案：

一、Server Key的配置方式（Admin SDK无需传统Server Key） #

你用的是Firebase Admin SDK，这种方式不需要直接使用GCM时期的Server Key，而是通过Firebase服务账号密钥来完成认证，步骤如下：

1. 在Firebase控制台生成服务账号密钥：

   • 进入你的项目 → 项目设置 → 服务账号 → 点击「生成新的私钥」，下载JSON格式的密钥文件。

2. 在后端初始化Admin SDK时配置密钥：
   有两种常用方式：

   • 环境变量方式（推荐，更安全）：设置系统环境变量 GOOGLE_APPLICATION_CREDENTIALS，值为你下载的JSON密钥文件的绝对路径，SDK会自动读取。
   • 代码加载方式：如果无法设置环境变量，也可以在代码中直接加载密钥文件：

     try {
         FileInputStream serviceAccount = new FileInputStream("path/to/your-service-account-key.json");
     
         FirebaseOptions options = new FirebaseOptions.Builder()
             .setCredentials(GoogleCredentials.fromStream(serviceAccount))
             .build();
     
         // 初始化Firebase App（全局只需初始化一次）
         if (FirebaseApp.getApps().isEmpty()) {
             FirebaseApp.initializeApp(options);
         }
     } catch (IOException e) {
         e.printStackTrace();
     }
     

注意：Admin SDK的服务账号密钥拥有项目的高权限，一定要妥善保管，不要暴露在客户端代码中。

二、MessageException的捕获与处理 #

发送消息时抛出的MessageException包含了具体的错误原因，我们可以根据错误类型做针对性处理，示例代码如下：

String registrationToken = "YOUR_REGISTRATION_TOKEN";
Message message = Message.builder()
    .putData("score", "850")
    .putData("time", "2:45")
    .setToken(registrationToken)
    .build();

try {
    String response = FirebaseMessaging.getInstance().send(message);
    System.out.println("消息发送成功：" + response);
} catch (MessageException e) {
    System.err.println("消息发送失败：" + e.getMessage());
    ErrorCode errorCode = e.getErrorCode();
    
    // 根据不同错误码处理
    switch (errorCode) {
        case INVALID_REGISTRATION:
            // 注册令牌无效，建议从数据库中移除该令牌，避免重复发送
            System.out.println("无效的注册令牌，已标记清理");
            break;
        case UNREGISTERED:
            // 设备已注销该令牌，直接从数据库删除
            System.out.println("令牌已注销，已从数据库移除");
            break;
        case QUOTA_EXCEEDED:
            // 发送配额超出，需要稍后重试（可以用定时任务或队列处理）
            System.out.println("发送配额超出，将在1小时后重试");
            break;
        case SENDER_ID_MISMATCH:
            // 发送者ID不匹配，检查Firebase项目配置是否正确
            System.out.println("发送者ID不匹配，请检查项目配置");
            break;
        default:
            // 其他通用错误，记录日志以便排查
            System.out.println("未知错误：" + errorCode);
            break;
    }
}

核心思路是根据错误类型调整后续的消息发送逻辑，比如清理无效令牌、重试配额超限的请求等，避免无效请求反复触发错误。

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