FCM关联BigQuery推送报告出现UNKNOWN_OS等字段异常的原因问询

各异常字段对应原因 #

• sdk_platform=UNKNOWN_OS、instance_id/app_name为空：FCM只有在消息成功触达终端SDK时，才能采集到设备平台、应用包名、设备实例ID这类终端侧参数。如果消息在服务端处理阶段就被拦截、没有下发到设备，或者设备端SDK未正确回传识别信息，就会返回UNKNOWN_OS，对应字段留空。
• ttl=-1：FCM BigQuery导出规则中，ttl为-1代表服务端未读取到消息的TTL配置，或消息未进入下发队列就被终止处理。常见于无效发送请求、权限校验失败、无有效目标受众的消息，发送时未显式指定TTL参数也可能触发该默认值。
• message_type=TOPIC、message_id为空：message_id是FCM服务端成功受理下发任务后才会生成的唯一标识。如果你发送的是Topic类型消息，当该Topic无有效订阅用户时，FCM不会生成下发任务，自然不会分配message_id，仅会记录请求的消息类型为TOPIC。

排查建议 #

• 确认推送发送方式：若使用Topic发送，优先核查两台测试设备的Topic订阅状态，确认订阅请求返回成功。
• 核查FCM发送API调用日志，确认接口是否返回成功响应，4xx/5xx类错误响应对应的消息不会填充下发阶段的字段。
• 检查应用FCM SDK集成配置，确认未禁用数据上报相关能力，避免设备无法回传识别参数。

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