PHP集成Firebase推送通知：返回成功但Android设备未接收

这种情况确实挺头疼的——明明API返回成功，设备却没反应，我之前也遇到过类似的问题，咱们一步步排查：

1. 先确认PHP请求的Payload结构是否正确 #

Firebase的FCM消息分两种核心类型，处理逻辑完全不同：

• 通知消息（Notification Message）：包含notification字段时，后台状态下系统会自动弹出通知，前台状态下会触发onMessageReceived；
• 数据消息（Data Message）：只有data字段时，后台状态下不会自动展示通知，直接传递到onMessageReceived，前台状态才会触发该方法。

你可以试试用标准的完整Payload格式发送，确保覆盖不同场景：

$serverKey = "你的Firebase服务器密钥";
$deviceToken = "目标设备的有效令牌";

$payload = [
    'to' => $deviceToken,
    'notification' => [
        'title' => '测试通知',
        'body' => '来自PHP的推送测试',
        'sound' => 'default' // 加声音提示，更容易感知通知到达
    ],
    'data' => [
        'custom_key' => 'custom_value' // 自定义业务数据，可选
    ]
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://fcm.googleapis.com/fcm/send');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: key=' . $serverKey,
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));

$response = curl_exec($ch);
curl_close($ch);

echo $response;

2. 检查Android端的FCM配置是否完整 #

确保你的Android项目正确集成FCM，并且消息处理服务注册无误：

• 确认AndroidManifest.xml中注册了FirebaseMessagingService的子类：

<service
    android:name=".MyFirebaseMessagingService"
    android:exported="false">
    <intent-filter>
        <action android:name="com.google.firebase.MESSAGING_EVENT" />
    </intent-filter>
</service>

• 检查MyFirebaseMessagingService是否正确重写onMessageReceived，日志代码无错误：

@Override
public void onMessageReceived(RemoteMessage remoteMessage) {
    super.onMessageReceived(remoteMessage);
    Log.d("FCM_DEBUG", "收到消息: " + remoteMessage.toString());
    
    // 处理通知消息内容
    if (remoteMessage.getNotification() != null) {
        Log.d("FCM_DEBUG", "通知标题: " + remoteMessage.getNotification().getTitle());
        Log.d("FCM_DEBUG", "通知内容: " + remoteMessage.getNotification().getBody());
    }
    
    // 处理自定义数据
    if (remoteMessage.getData().size() > 0) {
        Log.d("FCM_DEBUG", "数据内容: " + remoteMessage.getData());
    }
}

注意：如果设备处于后台且Payload只有data字段，系统不会触发onMessageReceived，这时候需要添加notification字段，或者切换到前台测试。

3. 确认设备令牌的有效性 #

虽然API返回success:1和canonical_ids:0说明当前令牌有效，但还是建议你从Android设备获取最新令牌——令牌可能因应用卸载重装、系统更新等情况发生变化，确保PHP代码中使用的是最新值。

4. 检查PHP请求的Header是否正确 #

必须确保请求头包含两个关键配置：

• Authorization: key=你的服务器密钥：服务器密钥可在Firebase控制台「项目设置」→「云消息传递」中获取；
• Content-Type: application/json：缺少这个头，Firebase可能无法正确解析你的Payload。

5. 排查日志不显示的问题 #

如果onMessageReceived的日志没打印，可能是以下原因：

• 设备处于后台且Payload只有data字段：这种情况系统不会触发该方法，切换到前台测试或修改Payload添加notification字段；
• 日志过滤错误：在Android Studio的Logcat中，确保过滤的TAG是你代码中设置的FCM_DEBUG，日志级别选为Debug；
• 服务注册路径错误：检查AndroidManifest.xml中的服务路径是否与实际类路径一致，比如.MyFirebaseMessagingService是否匹配你的包结构。

按照以上步骤逐一排查，应该能定位到问题所在。

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