C#项目Firebase消息投递状态查询：卸载设备消息未送达如何识别？

我之前踩过FCM这个坑！确实，当用户卸载应用后，FCM不会主动通知你设备ID已失效，而且直接发POST请求时，哪怕设备ID已经无效，HTTP响应还是会返回200"成功"——但实际上消息根本无法送达。不过有几个靠谱的方法能帮你识别这些无效设备ID，进而清理数据库：

1. 解析FCM响应体，捕获错误状态 #

FCM的HTTP状态码200只代表请求本身被正常处理，不代表消息成功送达。你需要解析响应体中的错误字段，才能判断设备ID是否有效：

• 当设备ID已被注销（比如应用卸载），响应体里会返回"error": "UNREGISTERED"
• 如果设备ID格式错误或根本不存在，会返回"error": "INVALID_REGISTRATION"

不管是单条发送还是批量发送，都要检查这个字段。举个C#里的单条发送处理示例：

// 假设你已经构造好FCM请求内容并设置了Authorization头
var response = await _httpClient.PostAsync("https://fcm.googleapis.com/fcm/send", requestContent);
var fcmResponse = await response.Content.ReadFromJsonAsync<FcmSendResponse>();

if (!string.IsNullOrEmpty(fcmResponse.Error))
{
    if (fcmResponse.Error == "UNREGISTERED" || fcmResponse.Error == "INVALID_REGISTRATION")
    {
        // 从数据库中删除对应的失效设备ID
        await _deviceRepository.RemoveDeviceById(fcmResponse.RegistrationId);
    }
}

// 对应的响应模型类
public class FcmSendResponse
{
    public string MessageId { get; set; }
    public string Error { get; set; }
    public string RegistrationId { get; set; } // 批量发送时会返回该字段
}

如果是批量发送多个设备ID，FCM会返回一个results数组，每个元素对应一个设备的发送状态，你可以遍历数组批量处理失效ID。

2. 用validate_only参数批量验证设备ID #

如果你的数据库里积累了很多旧设备ID，不想真的发消息打扰用户，可以用FCM的validate_only参数做有效性校验——这个参数会让FCM只验证设备ID是否有效，不会实际推送消息。

你可以写一个定时任务（比如每周一次），批量拿数据库里的设备ID去验证：

var validationRequest = new
{
    to = "要验证的设备ID",
    validate_only = true,
    notification = new { title = "Validation Check", body = "Ignore this" }
};

var content = new StringContent(JsonSerializer.Serialize(validationRequest), Encoding.UTF8, "application/json");
content.Headers.Add("Authorization", "key=你的FCM服务器密钥");

var response = await _httpClient.PostAsync("https://fcm.googleapis.com/fcm/send", content);
var validationResult = await response.Content.ReadFromJsonAsync<FcmSendResponse>();

if (validationResult.Error is "UNREGISTERED" or "INVALID_REGISTRATION")
{
    // 删除无效ID
    await _deviceRepository.RemoveDeviceById(validationResult.RegistrationId);
}

3. 辅助手段：客户端定期上报活跃状态 #

虽然没有直接的应用卸载回调，但可以让客户端每次启动时，向你的服务器上报一次设备ID和当前时间。然后你可以设置一个阈值（比如30天），如果某个设备ID超过阈值没有上报，就标记为"疑似失效"，再用上面的方法做最终验证后删除。这个方法能帮你提前筛选出可能失效的ID，减少不必要的FCM请求。

总结 #

最核心的解决方案就是不要只看HTTP状态码，一定要解析FCM响应体里的错误字段——这是FCM告诉你设备ID失效的直接方式。结合定期批量验证和客户端活跃上报，就能保持数据库里的设备ID都是有效的，避免无效推送浪费资源。

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