Firebase Admin SDK 2.3版在.NET API中无法发送FCM消息的排查求助

1. 修复异步方法的调用逻辑 #

你的方法定义为private void FirebaseMessagingAsync(...)，但内部调用异步方法SendMulticastAsync时未使用await，会导致异步操作被“静默丢弃”——可能在任务完成前就终止执行，也无法捕获异步抛出的异常。

修改方法签名并添加等待逻辑：

private async Task FirebaseMessagingAsync(List<int> send_user_ids, string title, string body)
{
    // ... 原有代码 ...

    try
    {
        var response = await FirebaseMessaging.DefaultInstance.SendMulticastAsync(multiMessage);
        // 后续处理返回结果
    }
    catch (Exception ex)
    {
        // 记录异常信息
    }
}

调用该方法的地方也需使用await，保证异步流程完整执行。

2. 完善异常处理与日志记录 #

当前异常处理仅将异常赋值给变量，完全无法排查问题。需添加详细日志，记录：

• 异常的完整堆栈信息
• 发送的消息内容（标题、正文）
• 目标FCM Token列表
• Firebase初始化状态

示例日志代码（可根据项目日志框架调整）：

catch (Exception ex)
{
    File.AppendAllText("fcm_error.log", 
        $"[{DateTime.Now}] 发送失败: {ex.Message}\n堆栈跟踪: {ex.StackTrace}\n目标Token: {string.Join(",", registrationTokens)}\n");
}

3. 解析SendMulticastAsync的返回结果 #

SendMulticastAsync返回的BatchResponse包含每个Token的发送状态——即使没有抛出全局异常，也可能存在部分或全部Token发送失败的情况。必须处理返回结果定位问题：

var response = await FirebaseMessaging.DefaultInstance.SendMulticastAsync(multiMessage);

// 记录整体发送统计
File.AppendAllText("fcm_log.log", 
    $"[{DateTime.Now}] 发送结果: 成功{response.SuccessCount}条，失败{response.FailureCount}条\n");

// 遍历失败条目，获取具体错误原因
for (int i = 0; i < response.Responses.Count; i++)
{
    if (!response.Responses[i].IsSuccess)
    {
        var error = response.Responses[i].Error;
        File.AppendAllText("fcm_error.log", 
            $"[{DateTime.Now}] Token {registrationTokens[i]} 发送失败: {error.Message} (错误码: {error.Code})\n");
    }
}

4. 验证Firebase初始化与配置 #

• 确认服务账号JSON文件路径正确：检查AppDomain.CurrentDomain.BaseDirectory + "\\...wafle-....json"的路径是否准确，文件是否存在且应用有读取权限。
• 添加初始化状态日志：

if (FirebaseApp.DefaultInstance == null)
{
    try
    {
        var credential = GoogleCredential.FromFile(AppDomain.CurrentDomain.BaseDirectory + "\\...wafle-....json");
        FirebaseApp.Create(new AppOptions() { Credential = credential });
        File.AppendAllText("fcm_log.log", $"[{DateTime.Now}] Firebase App初始化成功\n");
    }
    catch (Exception ex)
    {
        File.AppendAllText("fcm_error.log", $"[{DateTime.Now}] Firebase初始化失败: {ex.Message}\n");
        return;
    }
}

5. 单Token测试 #

从Firebase控制台能成功发送的设备中选取一个有效Token，硬编码到registrationTokens列表中单独测试，排除批量发送时无效Token的干扰，确认单条消息能否正常送达。

Firebase Admin SDK 2.3是发布于2018年的老旧版本，存在已知的异步处理bug、API兼容性问题，且官方已停止对该版本的维护与bug修复。

即使通过上述步骤定位到问题，老版本也可能无法解决某些底层问题。强烈建议升级到最新稳定版本（截至2024年，.NET平台最新版本为FirebaseAdmin v12.x），新版本修复了大量bug，提供了更完善的错误处理机制，也能更好兼容最新FCM协议。

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