Oreo及以上版本自定义Service通知样式失效，如何修复？

我之前在适配Android Oreo的时候也踩过这个一模一样的坑！先给你理清楚核心变更和修复步骤：

一、Oreo（API 26）之后的关键变更 #

从Oreo开始，Android引入了NotificationChannel强制机制，同时对后台Service的通知行为做了严格限制：

• 所有通知必须关联到已创建的NotificationChannel，否则无法显示
• 非前台Service的后台通知会被系统自动添加“点击查看更多信息或停止应用”的提示栏，并且自定义布局/操作可能被系统拦截
• 后台Service如果长期运行，必须升级为前台Service（调用startForeground()），否则系统会优先回收这类Service

二、修复步骤 #

1. 声明必要权限 #

根据你的Android版本，在AndroidManifest.xml中添加对应权限：

<!-- Android 9+ 基础前台Service权限 -->
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<!-- Android 12+ 按Service用途选择细分权限，比如媒体类用这个 -->
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA" />

2. 创建正确的NotificationChannel #

确保你的通知频道配置符合前台Service的要求，避免系统拦截自定义视图：

// Kotlin示例，Java写法类似
val channelId = "bg_service_custom_channel"
val notificationManager = getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager

// 仅在API 26+创建频道
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
    val channel = NotificationChannel(
        channelId,
        "后台服务状态", // 频道名称，用户可见
        NotificationManager.IMPORTANCE_DEFAULT // 重要度设为默认，保证自定义视图正常显示
    ).apply {
        description = "显示后台服务的自定义操作与状态"
        lockscreenVisibility = Notification.VISIBILITY_PUBLIC // 允许锁屏显示自定义内容
        setShowBadge(false) // 如果不需要角标可以关闭
    }
    notificationManager.createNotificationChannel(channel)
}

3. 构建自定义通知并启动前台Service #

关键：不能用普通的notify()，必须调用startForeground()，这是去掉系统默认提示的核心：

// 加载自定义布局（折叠状态+展开状态）
val collapsedView = RemoteViews(packageName, R.layout.notification_collapsed)
val expandedView = RemoteViews(packageName, R.layout.notification_expanded)

// 配置自定义操作（比如点击按钮启动Service/Activity）
val intent = Intent(this, YourService::class.java).apply {
    action = "ACTION_CUSTOM_OPERATION"
}
val pendingIntent = PendingIntent.getService(
    this,
    0,
    intent,
    // Android 12+ 必须设置FLAG_IMMUTABLE或FLAG_MUTABLE
    PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_IMMUTABLE
)
collapsedView.setOnClickPendingIntent(R.id.btn_custom, pendingIntent)

// 构建通知
val notification = NotificationCompat.Builder(this, channelId)
    .setSmallIcon(R.drawable.ic_service_small) // 必须设置，否则通知无法显示
    .setCustomContentView(collapsedView) // 折叠状态的自定义布局
    .setCustomBigContentView(expandedView) // 展开状态的自定义布局
    .setPriority(NotificationCompat.PRIORITY_DEFAULT)
    .setOngoing(true) // 设为持续通知，防止用户手动取消（前台Service默认行为）
    .build()

// 启动前台Service，通知ID不能为0
startForeground(1001, notification)

4. 自定义布局的注意事项 #

Oreo之后系统对自定义通知布局的尺寸限制更严格：

• 折叠状态布局高度≤64dp
• 展开状态布局高度≤256dp
• 避免使用过大的控件或复杂布局，否则会被系统强制截断或替换为默认样式

三、为什么之前的代码在Oreo前正常？ #

Oreo之前没有NotificationChannel强制要求，后台Service可以直接用notify()显示自定义通知，系统不会添加额外提示。但Oreo为了优化后台功耗和用户透明度，强制要求后台长期运行的Service必须以前台Service身份显示通知，否则会被系统限制。

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