react-native-image-picker调用launchImageLibrary提示Unable to Load Photos如何解决

该错误通常由移动端相册访问权限未正确配置导致，与现有JS代码逻辑无关，可按以下步骤分平台排查修复：

iOS端配置 #

• 打开ios项目下的Info.plist文件，添加相册访问权限声明：
  • 必须配置NSPhotoLibraryUsageDescription字段，值填写申请权限的合理说明，例如“需要访问相册以选择待上传的图片”
  • 若涉及拍照、保存图片到相册的需求，还需额外配置NSCameraUsageDescription、NSPhotoLibraryAddUsageDescription字段及对应说明
• 配置完成后进入ios目录执行pod install，重新编译项目后生效
• iOS14及以上系统若用户仅授权部分照片访问权限也可能触发该提示，可在调用launchImageLibrary时新增参数selectionLimit: 0（0代表不限制选择数量）兼容该场景

Android端配置 #

• 打开android/app/src/main/AndroidManifest.xml文件，按系统版本添加对应存储权限：
  • 安卓13及以上：添加<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
  • 安卓12及以下：添加<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
  • 若涉及拍照需求，额外添加<uses-permission android:name="android.permission.CAMERA" />
• 配置完成后重新编译项目生效

通用排查步骤 #

若完成权限配置后问题仍然存在，可尝试以下操作：

• 卸载设备上已安装的旧版应用，重新安装新版本，确保权限配置被系统正确读取
• 唤起图片选择器之前，先通过PermissionsAndroid或第三方权限管理库主动申请相册权限，确认获得授权后再调用launchImageLibrary方法
• 检查当前react-native-image-picker版本与项目React Native版本的兼容性，0.60以下的RN版本需要手动执行react-native link react-native-image-picker完成依赖关联，0.60及以上版本支持自动关联无需手动操作

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