Android Nougat 7.0及以下通知正常，Oreo 8.0无法显示，如何解决？

问题根源 #

嘿，这个问题我太熟了——Android 8.0（API 级别26）引入了**通知渠道（Notification Channel）**的强制要求：所有通知必须绑定到一个已创建的通知渠道才能在系统中显示。你的代码里缺少创建渠道的逻辑，所以在7.0及以下的旧系统能正常工作，但到了Oreo就直接失效了。

解决方案步骤 #

• 第一步：添加通知渠道创建逻辑
  在App启动时（比如MainActivity的onCreate方法里）加入这段代码，它只会在API 26及以上的系统中执行：

  private void createNotificationChannel() {
      // 仅针对Oreo及以上版本处理
      if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
          CharSequence channelName = "App通知渠道"; // 用户在系统设置里能看到的渠道名称
          String channelDesc = "接收App的各类通知提醒"; // 渠道的描述说明
          int importance = NotificationManager.IMPORTANCE_DEFAULT; // 通知重要性，决定弹窗/提示音等行为
          
          // 创建渠道实例并注册到系统
          NotificationChannel channel = new NotificationChannel(ChannelId, channelName, importance);
          channel.setDescription(channelDesc);
          NotificationManager notificationManager = getSystemService(NotificationManager.class);
          notificationManager.createNotificationChannel(channel);
      }
  }
  

• 第二步：确保通知绑定渠道
  你的通知构建代码里，要在NotificationCompat.Builder的构造方法中传入定义好的ChannelId（旧系统会自动忽略这个参数，不影响兼容性）：

  // 构建通知内容
  NotificationCompat.Builder builder = new NotificationCompat.Builder(this, ChannelId)
          .setSmallIcon(R.drawable.ic_notification_icon) // 必须设置小图标，否则通知不会显示
          .setContentTitle("新通知")
          .setContentText("这是一条能在Oreo上正常显示的通知")
          .setPriority(NotificationCompat.PRIORITY_DEFAULT);
  
  // 发送通知
  NotificationManagerCompat notificationManager = NotificationManagerCompat.from(this);
  notificationManager.notify(NotificationId, builder.build());
  

完整修改后的代码示例 #

public class MainActivity extends AppCompatActivity {
    Button button;
    private final String ChannelId = "Notification";
    private final Integer NotificationId = 1; // 建议用1代替001，避免整数字面量的八进制歧义

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        
        // 先创建通知渠道，保证后续通知能正常显示
        createNotificationChannel();
        
        button = findViewById(R.id.button);
        button.setOnClickListener(v -> sendTestNotification());
    }

    // 创建通知渠道的工具方法
    private void createNotificationChannel() {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
            CharSequence channelName = getString(R.string.notification_channel_name);
            String channelDesc = getString(R.string.notification_channel_description);
            int importance = NotificationManager.IMPORTANCE_DEFAULT;
            
            NotificationChannel channel = new NotificationChannel(ChannelId, channelName, importance);
            channel.setDescription(channelDesc);
            
            NotificationManager notificationManager = getSystemService(NotificationManager.class);
            notificationManager.createNotificationChannel(channel);
        }
    }

    // 发送测试通知的方法
    private void sendTestNotification() {
        NotificationCompat.Builder builder = new NotificationCompat.Builder(this, ChannelId)
                .setSmallIcon(R.drawable.ic_launcher_foreground) // 注意：小图标是必填项
                .setContentTitle("测试通知")
                .setContentText("Oreo及以上系统终于能看到我啦！")
                .setPriority(NotificationCompat.PRIORITY_DEFAULT);

        NotificationManagerCompat notificationManager = NotificationManagerCompat.from(this);
        notificationManager.notify(NotificationId, builder.build());
    }
}

额外注意事项 #

• 通知渠道一旦创建，它的重要性、名称、描述等核心属性就无法通过代码修改了，用户只能在系统设置的「通知」页面手动调整，所以创建时要设置合适的初始值。
• 无论哪个Android版本，通知的smallIcon都是必填项，缺失的话通知大概率不会显示。
• NotificationId建议使用非零整数，虽然0也能工作，但可以避免和系统内置通知ID冲突。

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