react-native-image-picker未请求相册权限问题求助

问题描述 #

运行react-native-image-picker官方示例时，点击“Select Image”直接打开相册，未弹出权限请求弹窗。已在AndroidManifest.xml中添加以下权限但无效果：

<uses-permission android:name="android.permission.READ_MEDIA_IMAGES"/>
<uses-permission android:name="android.permission.ACTION_OPEN_DOCUMENT"/>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.GALLERY"/>

解决方案 #

1. 清理无效权限并规范权限声明 #

先删除Manifest里的无效权限：

• ACTION_OPEN_DOCUMENT是Intent动作，不属于权限范畴，无需声明
• GALLERY不是标准Android权限，无实际作用
  保留适配不同Android版本的必要权限，建议加上maxSdkVersion区分版本：

<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" android:maxSdkVersion="33" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32" />

2. 手动添加权限检查与请求逻辑 #

react-native-image-picker默认不会主动请求权限——因为Android 10+的系统相册选择器可通过临时URI授权让APP访问选中的图片，无需提前申请存储权限。如果需要强制在打开相册前弹出权限请求，需在代码中手动检查并申请权限：

import { launchImageLibrary, checkPermissions, requestPermissions } from 'react-native-image-picker';
import { Platform } from 'react-native';

const selectImage = async () => {
  // 检查当前权限状态
  const permissionStatus = await checkPermissions();
  let hasValidPermission = false;

  if (Platform.OS === 'android') {
    // 根据Android版本判断有效权限
    hasValidPermission = permissionStatus.android?.readMediaImages || permissionStatus.android?.readExternalStorage;
  }

  // 无权限则发起请求
  if (!hasValidPermission) {
    const requestResult = await requestPermissions();
    hasValidPermission = Platform.OS === 'android' 
      ? requestResult.android?.readMediaImages || requestResult.android?.readExternalStorage
      : false;
  }

  // 有权限再打开相册选择器
  if (hasValidPermission) {
    launchImageLibrary(
      { mediaType: 'photo' },
      (response) => {
        // 处理图片选择结果
        console.log(response);
      }
    );
  }
};

3. 测试注意事项 #

• 如果之前已授权过权限，系统不会再次弹窗，可前往系统设置-应用权限重置当前APP的存储权限后再测试
• Android 13+的存储权限分为「单次允许」和「始终允许」，第一次请求会正常弹出权限选择弹窗

内容的提问来源于stack exchange，提问作者funky-nd