Android使用Intent.ACTION_VIEW打开刚创建的本地图片时黑屏

• 业务流程：用户点击蓝色下载按钮完成图片本地保存，保存成功后弹出Snackbar；点击Snackbar操作项时，调起系统图片查看器打开刚保存的图片
• 异常表现：刚保存的图片可以通过文件管理器、系统相册正常查看，但点击Snackbar操作项调起的系统图片查看器仅显示黑屏；手动重命名该图片后，使用同一段打开逻辑即可正常加载图片
• 已完成的排查项：
  • 确认图片文件生成正常、存储路径无错误
  • 替换其他本地图片测试，相同打开逻辑可以正常调起查看器，排除打开代码的基础逻辑错误
  • 测试设备SDK版本为21，已尝试过FileProvider方案，排除应用私有目录访问的安全限制问题

出现这个现象的核心是MediaStore媒体索引的同步时序不匹配：

1. 原代码使用的ACTION_MEDIA_MOUNTED是全量扫描外部存储的广播，在SDK21版本上，这种全量扫描需要遍历整个存储路径，耗时长且时序不可控；广播发出时刚写入的文件句柄可能还未完全释放，MediaStore索引中该固定路径下留存的是之前旧的空占位缓存，系统图片查看器会优先读取MediaStore的索引内容，自然会出现黑屏
2. 手动重命名图片的操作会触发系统文件变更监听，强制MediaStore为新路径生成全新的有效索引，不会命中旧的缓存内容，所以重命名后可以正常打开

• 替换全量扫描广播，改用单文件精准扫描
  删除原有的全量外部存储扫描广播，在图片流完全写入、关闭完成后，直接针对刚保存的单文件触发MediaScanner扫描，等系统完成该文件的索引构建后，再展示可点击的Snackbar：

  // 替换原有全量广播的代码
  MediaScannerConnection.scanFile(
      context,
      arrayOf(localFile.absolutePath),
      arrayOf("image/jpeg")
  ) { _, scanUri ->
      // 索引构建完成后，暂存这个有效uri，后续Snackbar点击打开时直接复用，不要重新拼接File的Uri
      pendingOpenUri = scanUri
      showSnackbarWithOpenAction()
  }
  

  这种方式不需要遍历整个外部存储，扫描速度极快，从根源上避免时序不同步的问题。
• 规避固定文件名的缓存命中问题
  保存图片时不要硬编码固定文件名picture.jpg，可以在文件名后拼接时间戳或随机值，比如picture_${System.currentTimeMillis()}.jpg，避免MediaStore对同一路径的旧缓存命中。
• 优化打开图片的Intent配置
  打开图片时优先使用MediaScanner返回的有效内容Uri，同时补全必要的启动标记，避免跨应用启动的上下文问题：

  val intent = Intent(Intent.ACTION_VIEW).apply {
      setDataAndType(pendingOpenUri, "image/*")
      addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION)
      addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
  }
  startActivity(intent)
  

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