React Native升级SDK34至Android14后本地图片不显示问题

可能原因及对应解决方案 #

1. 媒体文件访问权限变更（Android 14新增限制） #

Android 14针对媒体文件访问新增了READ_MEDIA_IMAGES权限，当targetSdkVersion升级到34后，原有的READ_EXTERNAL_STORAGE权限仅在Android 13及以下系统生效，Android 14需要单独申请新权限。

• 操作步骤：
  • 在AndroidManifest.xml中添加权限声明：

    <uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
    <!-- 兼容Android 13及以下系统，保留旧权限并限制最高生效版本 -->
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="33" />
    

  • 在代码中动态申请READ_MEDIA_IMAGES权限，申请逻辑与原有存储权限流程一致。

2. 本地文件路径访问限制收紧 #

Android 14对外部存储公共目录的直接访问限制更严格，若图片存放在应用私有存储之外的路径，可能被系统拦截。

• 修复建议：
  • 优先将本地图片存储到应用私有目录，比如getFilesDir()或getExternalFilesDir(Environment.DIRECTORY_PICTURES)，这类目录无需额外权限即可访问。
  • 若需访问公共媒体库的图片，改用MediaStore API查询获取，避免直接通过文件路径访问。

3. 第三方图片加载库兼容性问题 #

如果使用Glide、Picasso等图片加载库，旧版本可能未适配Android 14的文件访问规则，导致加载失败。

• 处理方式：
  • 将图片加载库升级到最新稳定版，例如Glide升级至4.16.0+，Picasso升级至2.8+。
  • 检查加载代码：若加载本地图片，确保传入的Uri是通过MediaStore获取的content://类型，而非直接的file:// Uri。

4. 资源缓存冲突 #

升级SDK后，项目可能存在旧资源缓存残留，导致本地图片无法正确加载。

• 解决步骤：
  • 执行Build > Clean Project和Build > Rebuild Project清理项目缓存。
  • 卸载设备上的现有应用后重新安装，避免旧缓存干扰。

5. file:// Uri暴露限制 #

Android 14禁止向其他应用暴露file://类型的Uri，若你的图片加载逻辑依赖此类Uri，会被系统拦截。

• 替代方案：
  • 通过ContentProvider封装本地文件，提供content://类型的Uri供图片加载库使用。
  • 将目标文件复制到应用私有目录后，通过私有路径加载。

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