安卓设备无法接收Firebase推送通知问题求助

Hey there, let's work through why your Android notifications aren't coming through—this is a super common snag for folks new to Firebase Cloud Messaging (FCM), so we'll break down the most likely fixes step by step.

1. 先确认设备FCM Token的有效性 #

First things first: make sure you're using a valid, up-to-date FCM Token for the target Android device. Tokens can change when the app is reinstalled, app data is cleared, or the device gets a system update.

• Add logging in your Android app to print the token when it's retrieved, then cross-check it with the token you're passing in your Functions code. Even a single typo or outdated token will block notifications.

2. 修正Firebase Admin SDK初始化方式 #

Your current initialization uses admin.initializeApp(functions.config().firebase);—this syntax is deprecated in newer Firebase Functions versions. Switch to the simplified, recommended initialization:

admin.initializeApp();

The old syntax can cause hidden configuration or permission issues that break notification delivery, so updating this is often a quick fix.

3. 确保通知Payload符合FCM规范 #

FCM has specific requirements for Android notification payloads. If yours is missing required fields or formatted incorrectly, the device won't display the notification. Here's a working example you can adapt:

// 示例：完整的通知发送函数
exports.sendUserNotification = functions.database.ref('/notifications/{userId}/{notificationId}')
    .onCreate((snapshot, context) => {
        const userId = context.params.userId;
        const notificationData = snapshot.val();

        // 从数据库获取用户的FCM Token（假设你存在这个路径下）
        return admin.database().ref(`/users/${userId}/fcmToken`).once('value')
            .then(tokenSnapshot => {
                const targetToken = tokenSnapshot.val();
                
                if (!targetToken) {
                    console.log(`No valid FCM token found for user: ${userId}`);
                    return null;
                }

                // 构建符合FCM要求的Payload
                const payload = {
                    notification: {
                        title: notificationData.title,
                        body: notificationData.message,
                        sound: 'default' // 加上声音提示，方便测试是否收到
                    },
                    token: targetToken
                };

                // 发送通知
                return admin.messaging().send(payload)
                    .then(response => {
                        console.log(`Notification sent successfully: ${response}`);
                        return null;
                    })
                    .catch(error => {
                        console.error(`Failed to send notification: ${error}`);
                    });
            });
    });

• Note: If you only use a data field in your payload, your Android app needs to manually handle displaying the notification in background. Using the notification field lets FCM handle showing it in the system tray, which is easier for testing.

4. 检查Android App的FCM集成配置 #

Even if your Functions code is correct, a misconfigured Android app will block notifications:

• Double-check that your app has the correct google-services.json file (downloaded directly from the Firebase Console, matching your app's package name).
• Ensure you've added the FCM dependency in your app's build.gradle (e.g., com.google.firebase:firebase-messaging).
• Verify that you've implemented a FirebaseMessagingService subclass and registered it properly in your AndroidManifest.xml.
• Test with battery saver mode turned off—many Android devices restrict background notifications when battery saver is enabled.

5. 查看Firebase Functions日志找报错 #

Head to your Firebase Console > Functions > Logs to check for errors when your function runs. Common issues you might see:

• InvalidRegistration: The token you're using is invalid or expired.
• PermissionDenied: Your service account lacks the Cloud Messaging Admin permission.
• Timeout errors: Your function logic is taking too long to execute—simplify it or increase the timeout limit.

6. 先做手动推送测试 #

Rule out app-side issues by sending a test notification directly from the Firebase Console's Cloud Messaging tab. Use the same token you're using in your Functions code. If this manual test works, the problem is in your Functions code; if it fails, focus on fixing your Android app's FCM integration.

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