当前位置：首页 > 文章列表 > 文章 > java教程 > Android13FCM通知无法显示解决方法

Android13FCM通知无法显示解决方法

2025-07-14 17:21:29 0浏览收藏

解决Android 13及更高版本中FCM通知不显示的问题，是Android开发者面临的常见挑战。本文针对FCM数据消息成功接收但系统通知不显示的现象，深入剖析了Android 13引入的通知运行时权限这一核心原因。我们提供了从AndroidManifest.xml权限声明到运行时权限请求的完整解决方案，并结合详细的代码示例，指导开发者如何确保FCM数据消息能够正确转化为用户可见的本地通知。同时，文章还涵盖了Android通知系统的重要配置，如通知渠道的创建和使用，确保通知的正常显示。通过本文，开发者可以快速定位并解决Android 13上FCM通知显示问题，提升用户体验。

解决Android 13+ FCM数据消息通知不显示问题：运行时权限与最佳实践

本教程详细探讨了在Android 13及更高版本中，FCM（Firebase Cloud Messaging）数据消息虽已成功接收但系统通知不显示的问题。核心原因在于Android 13引入的通知运行时权限。文章将提供从权限声明到运行时请求的完整解决方案，并结合实际代码示例，指导开发者确保FCM数据消息能够正确地在用户设备上显示为本地通知，同时涵盖Android通知系统的其他关键配置，如通知渠道。

FCM数据消息与本地通知的挑战

Firebase Cloud Messaging (FCM) 提供了两种主要的消息类型：通知消息（Notification Message）和数据消息（Data Message）。当应用需要完全控制通知的显示方式、处理自定义数据或在应用处于前台时接收消息时，通常会选择发送数据消息。数据消息的特点是，无论应用处于前台、后台还是被杀死，都会触发FirebaseMessagingService中的onMessageReceived()回调方法。

开发者通常会在onMessageReceived()方法中解析收到的数据，并使用Android的NotificationManager和NotificationCompat.Builder来构建并显示一个本地通知。以下是常见的实现模式：

public class MyFirebaseMessagingService extends FirebaseMessagingService {

    @Override
    public void onMessageReceived(@NonNull RemoteMessage remoteMessage) {
        // 确保收到的是数据消息，并从getData()中解析
        if (remoteMessage.getData().size() > 0) {
            String notificationTitle = remoteMessage.getData().get("title");
            String notificationBody = remoteMessage.getData().get("body");
            String clickAction = remoteMessage.getData().get("click_action"); // 示例自定义字段

            Log.d("FCM_Debug", "Notification Data: " + notificationTitle + " " + notificationBody + " " + clickAction);

            // 调用方法显示本地通知
            sendLocalNotification(notificationTitle, notificationBody, clickAction);
        }
    }

    private void sendLocalNotification(String notificationTitle, String notificationBody, String url) {
        NotificationCompat.Builder notificationBuilder;
        // 定义通知点击行为：如果url为空或空字符串，则打开应用主界面；否则，打开指定URL
        if (url == null || url.length() == 0) {
            Intent intent = new Intent(this, record_viewer.class); // 示例：打开应用内某个Activity
            intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);
            PendingIntent pendingIntent = PendingIntent.getActivity(this, 0, intent, PendingIntent.FLAG_ONE_SHOT | PendingIntent.FLAG_IMMUTABLE); // FLAG_IMMUTABLE 是Android 12+必需
            Uri defaultSoundUri = RingtoneManager.getDefaultUri(RingtoneManager.TYPE_NOTIFICATION);

            notificationBuilder = new NotificationCompat.Builder(this, "CHANNEL_ID") // 确保使用有效的CHANNEL_ID
                    .setAutoCancel(true)
                    .setSmallIcon(R.mipmap.ic_launcher) // 确保图标存在且为有效资源ID
                    .setContentIntent(pendingIntent)
                    .setContentTitle(notificationTitle)
                    .setContentText(notificationBody)
                    .setSound(defaultSoundUri);
        } else {
            Intent notificationIntent = new Intent(Intent.ACTION_VIEW);
            notificationIntent.setData(Uri.parse(url));
            PendingIntent pending = PendingIntent.getActivity(this, 0, notificationIntent, PendingIntent.FLAG_ONE_SHOT | PendingIntent.FLAG_IMMUTABLE);
            Uri defaultSoundUri = RingtoneManager.getDefaultUri(RingtoneManager.TYPE_NOTIFICATION);

            notificationBuilder = new NotificationCompat.Builder(this, "CHANNEL_ID") // 确保使用有效的CHANNEL_ID
                    .setAutoCancel(true)
                    .setSmallIcon(R.drawable.download_icon) // 确保图标存在且为有效资源ID
                    .setContentIntent(pending)
                    .setContentTitle(notificationTitle)
                    .setContentText(notificationBody)
                    .setSound(defaultSoundUri);
        }

        NotificationManager notificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
        notificationManager.notify(1234, notificationBuilder.build());
    }
}

尽管日志显示数据已成功接收，但用户却无法在设备上看到通知。这通常是由于Android系统对通知显示权限的收紧所致。

Android 13 (API 33) 通知运行时权限

从Android 13 (API 级别 33) 开始，Google引入了一项新的运行时权限：POST_NOTIFICATIONS。这意味着应用在向用户显示通知之前，必须明确请求并获得此权限。如果应用的目标SDK版本为33或更高，并且未获得此权限，那么即使调用NotificationManager.notify()，通知也不会显示给用户。

这是为了给用户更多的控制权，允许他们决定哪些应用可以发送通知，从而减少不必要的干扰。

解决方案：权限声明与运行时请求

解决FCM数据消息无法显示本地通知的问题，需要以下两个步骤：

1. 在 AndroidManifest.xml 中声明权限

首先，在应用的AndroidManifest.xml文件中声明POST_NOTIFICATIONS权限。这是所有Android版本都需要的，但对于API 33及以上版本，它会触发运行时权限请求。

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.yourapp">

    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.POST_NOTIFICATIONS" /> <!-- Android 13+ 通知权限 -->

    <application
        <!-- ... 其他应用配置 ... -->
        <service
            android:name=".MyFirebaseMessagingService"
            android:exported="false">
            <intent-filter>
                <action android:name="com.google.firebase.MESSAGING_EVENT" />
            </intent-filter>
        </service>
        <!-- ... 其他组件 ... -->
    </application>
</manifest>

2. 在运行时请求权限（针对 Android 13+）

对于目标SDK版本为33或更高的应用，在尝试显示通知之前，必须在用户界面中适当地请求POST_NOTIFICATIONS权限。这通常在应用的启动流程中，或在用户首次需要接收通知功能时进行。

推荐使用ActivityResultLauncher来处理权限请求的回调：

import android.Manifest;
import android.content.pm.PackageManager;
import android.os.Build;
import android.os.Bundle;
import androidx.activity.result.ActivityResultLauncher;
import androidx.activity.result.contract.ActivityResultContracts;
import androidx.appcompat.app.AppCompatActivity;
import androidx.core.content.ContextCompat;

public class MainActivity extends AppCompatActivity {

    // 用于处理权限请求结果的Launcher
    private final ActivityResultLauncher<String> requestPermissionLauncher =
            registerForActivityResult(new ActivityResultContracts.RequestPermission(), isGranted -> {
                if (isGranted) {
                    // 权限已授予。现在可以显示通知了。
                    Log.d("Permission", "Notification permission granted.");
                    // 如果有待处理的通知，可以在这里尝试重新显示
                } else {
                    // 权限被拒绝。通知用户或禁用相关通知功能。
                    Log.d("Permission", "Notification permission denied.");
                    // 可以引导用户去设置中手动开启
                }
            });

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // 在合适的时机调用此方法请求通知权限
        requestNotificationPermission();
    }

    private void requestNotificationPermission() {
        // 仅在Android 13 (API 33) 及更高版本上才需要运行时请求
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
            if (ContextCompat.checkSelfPermission(this, Manifest.permission.POST_NOTIFICATIONS) ==
                    PackageManager.PERMISSION_GRANTED) {
                // 权限已授予，无需再次请求
                Log.d("Permission", "Notification permission already granted.");
            } else if (shouldShowRequestPermissionRationale(Manifest.permission.POST_NOTIFICATIONS)) {
                // 如果用户之前拒绝过但没有勾选“不再询问”，则显示一个解释性UI
                // 解释为什么应用需要此权限，然后再次请求
                Log.d("Permission", "Should show permission rationale for notifications.");
                // 可以在这里显示一个AlertDialog，解释原因，然后调用requestPermissionLauncher.launch()
                requestPermissionLauncher.launch(Manifest.permission.POST_NOTIFICATIONS);
            } else {
                // 直接请求权限
                Log.d("Permission", "Requesting notification permission directly.");
                requestPermissionLauncher.launch(Manifest.permission.POST_NOTIFICATIONS);
            }
        }
    }
}

注意事项：

API 版本检查： 务必使用Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU来判断当前设备是否为Android 13或更高版本。低于此版本的设备不需要运行时请求此权限。
请求时机： 选择一个合适的时机请求权限，例如在应用首次启动时，或者当用户点击某个需要通知功能按钮时。避免在应用启动时立即强制请求，这可能会影响用户体验。
用户体验： 如果shouldShowRequestPermissionRationale()返回true，这意味着用户之前拒绝过权限但没有选择“不再询问”。此时，最好向用户解释为什么应用需要通知权限，这有助于提高用户授权的意愿。

完善本地通知逻辑：通知渠道 (Android 8.0+)

虽然不是FCM数据消息不显示通知的直接原因，但从Android 8.0 (API 26) 开始，所有通知都必须分配到一个通知渠道 (Notification Channel)。如果没有为通知指定渠道，或者指定的渠道无效，通知将不会显示。这是一个常见的遗漏点，也可能导致通知不显示。

在sendLocalNotification方法中，确保在构建NotificationCompat.Builder之前创建并注册了通知渠道。通知渠道只需创建一次，通常在Application类的onCreate方法中，或在首次显示通知时调用。

import android.app.NotificationChannel;
import android.app.NotificationManager;
import android.content.Context;
import android.os.Build;
// ... 其他导入

public class MyFirebaseMessagingService extends FirebaseMessagingService {

    private static final String CHANNEL_ID = "my_app_notification_channel"; // 定义一个唯一的渠道ID
    private static final CharSequence CHANNEL_NAME = "通用通知"; // 用户可见的渠道名称
    private static final String CHANNEL_DESCRIPTION = "此渠道用于接收应用的重要通知"; // 用户可见的渠道描述

    @Override
    public void onCreate() {
        super.onCreate();
        createNotificationChannel(); // 在服务创建时创建通知渠道
    }

    private void createNotificationChannel() {
        // 仅在Android 8.0 (API 26) 及更高版本上需要通知渠道
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
            int importance = NotificationManager.IMPORTANCE_DEFAULT; // 通知重要性级别
            NotificationChannel channel = new NotificationChannel(CHANNEL_ID, CHANNEL_NAME, importance);
            channel.setDescription(CHANNEL_DESCRIPTION);
            // 将渠道注册到系统
            NotificationManager notificationManager = getSystemService(NotificationManager.class);
            if (notificationManager != null) {
                notificationManager.createNotificationChannel(channel);
            }
        }
    }

    private void sendLocalNotification(String notificationTitle, String notificationBody, String url) {
        // ... (省略部分代码，与之前相同)

        NotificationCompat.Builder notificationBuilder;
        if (url == null || url.length() == 0) {
            // ... (省略部分代码)
            notificationBuilder = new NotificationCompat.Builder(this, CHANNEL_ID) // 确保使用定义的CHANNEL_ID
                    .setAutoCancel(true)
                    .setSmallIcon(R.mipmap.ic_launcher)
                    .setContentIntent(pendingIntent)
                    .setContentTitle(notificationTitle)
                    .setContentText(notificationBody)
                    .setSound(defaultSoundUri);
        } else {
            // ... (省略部分代码)
            notificationBuilder = new NotificationCompat.Builder(this, CHANNEL_ID) // 确保使用定义的CHANNEL_ID
                    .setAutoCancel(true)
                    .setSmallIcon(R.drawable.download_icon)
                    .setContentIntent(pending)
                    .setContentTitle(notificationTitle)
                    .setContentText(notificationBody)
                    .setSound(defaultSoundUri);
        }

        NotificationManager notificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
        notificationManager.notify(1234, notificationBuilder.build());
    }
}

确保NotificationCompat.Builder的构造函数中传入了正确的CHANNEL_ID。

总结与注意事项

权限是关键： 对于Android 13 (API 33) 及更高版本，POST_NOTIFICATIONS运行时权限是FCM数据消息显示本地通知的必要条件。务必在AndroidManifest.xml中声明，并在运行时向用户请求。
渠道不可少： 对于Android 8.0 (API 26) 及更高版本，所有通知都必须关联到有效的通知渠道。确保您的应用正确创建并使用了通知渠道。
版本兼容性： 编写代码时，始终考虑不同Android版本的差异。使用Build.VERSION.SDK_INT进行条件判断，以确保在旧版本系统上不执行不必要的操作，在新版本系统上遵循新规范。
用户体验： 在请求敏感权限（如通知权限）时，提供清晰的解释，帮助用户理解为何需要此权限，可以显著提高用户授权的意愿。
FCM消息类型： 本教程主要针对FCM“数据消息”的情况。如果您发送的是FCM“通知消息”，当应用处于后台或被杀死时，FCM SDK可能会自动处理并显示通知，无需您手动在onMessageReceived中创建本地通知。只有当应用处于前台时，通知消息才会触发onMessageReceived。

通过遵循上述步骤和最佳实践，您可以确保您的FCM数据消息在各种Android版本和设备上都能可靠地显示为本地通知，从而提供一致且高效的用户体验。

到这里，我们也就讲完了《Android13FCM通知无法显示解决方法》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！