Firebase推送通知图片无法显示求助：小米/三星设备异常

一、先排查基础配置问题 #

• 必须用HTTPS的图片链接，小米、三星对HTTP链接拦截很严，还要确认链接没有过期、不需要额外权限就能访问，别让首次推送时链接已经失效。
• 推送payload的图片字段别填错：用Firebase控制台的话，要在「高级选项」里正确填image字段；自定义推送的话，Android端要对应notification.image或data.image（自己处理逻辑时）。
• 图片规格要合规：用PNG或JPG，文件控制在1MB以内，尺寸适配通知栏（比如1080*1920以内），太大的图厂商系统直接拒绝加载。

二、针对厂商系统适配 #

小米首次加载失败 #

• 小米的省电策略会杀后台，首次推送时App没启动的话，WorkManager或普通后台服务容易被拦截。试试：
  • 处理推送时先启动前台服务，再下载图片，前台服务优先级高，不容易被系统干掉。
  • 引导用户开App的「自启动权限」和「后台弹出界面权限」，小米后台操作基本都要这俩权限。

三星始终不显示 #

• 三星One UI对通知图片有特殊缓存机制，而且默认拦截远程图片加载：
  • 别依赖远程URL加载，改成本地预缓存：App启动时就把常用通知图缓存到本地，推送时直接读本地文件路径。
  • 下载的图片要存到App外部存储（getExternalFilesDir()），用FileProvider生成可访问的Uri，再放到BigPictureStyle里——三星要求通知图必须是本地文件。
  • 检查「智能管理器」有没有拦App的网络请求，确保后台网络权限开着。

三、代码优化要点 #

• 别用WorkManager处理首次推送的图片下载，直接在FirebaseMessagingService的onMessageReceived里开子线程下载，这个方法优先级高，厂商不会轻易拦截。
• 用COIL下载时加重试和硬件禁用：

val request = ImageRequest.Builder(context)
    .data(imageUrl)
    .allowHardware(false) // 部分厂商硬件加速会导致加载失败
    .listener(object : ImageRequest.Listener {
        override fun onSuccess(request: ImageRequest, metadata: ImageResult.Metadata) {
            // 下载成了就构建通知
        }

        override fun onError(request: ImageRequest, result: ImageResult.Error) {
            // 重试2-3次，或者显示默认图
        }
    })
    .build()
ImageLoader(context).enqueue(request)

• 通知必须用BigPictureStyle，而且要同时设bigPicture和bigLargeIcon：

val notificationBuilder = NotificationCompat.Builder(context, CHANNEL_ID)
    .setSmallIcon(R.drawable.ic_notification)
    .setContentTitle(title)
    .setContentText(content)
    .setStyle(NotificationCompat.BigPictureStyle()
        .bigPicture(bitmap)
        .bigLargeIcon(null)) // 空大图标避免遮挡图片

四、最后几个排查点 #

• 用真实设备测，模拟器的厂商限制和真机差太多。
• targetSdk >=33的话，要申请POST_NOTIFICATIONS权限，还要确保INTERNET和ACCESS_NETWORK_STATE权限都加了；Android13+后台网络受限，要是用HTTP链接（不推荐），得在Manifest加android:usesCleartextTraffic="true"。
• 看系统日志：用adb logcat过滤App包名或NotificationManager，找「图片加载失败」「权限被拒」这类错误日志，精准定位问题。

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