React Native中react-native-image-picker的launchImageLibrary报null错误

针对你在iOS模拟器中使用react-native-image-picker时遇到的这个错误，以下是几个针对性的解决步骤：

1. 补全iOS权限配置 #

除了已添加的NSPhotoLibraryUsageDescription，iOS 14及以上版本还需配置NSPhotoLibraryAddUsageDescription（即使仅读取相册，部分场景下也需要该权限）。在ios/[项目名]/Info.plist中添加：

<key>NSPhotoLibraryUsageDescription</key>
<string>需要访问您的相册以选择图片</string>
<key>NSPhotoLibraryAddUsageDescription</key>
<string>需要访问您的相册以保存图片</string>

2. 清理缓存并重建项目 #

缓存问题是RN开发中常见的模块加载异常原因，执行以下步骤：

• 清除Metro缓存：

  npx react-native start --reset-cache
  

• 删除iOS构建目录：

  cd ios && rm -rf build
  

• 重新集成Pods并构建：

  pod deintegrate && pod install
  cd .. && npx react-native run-ios
  

3. 改用初始化式调用方式 #

部分场景下，直接导入launchImageLibrary会出现模块加载不完整的问题，尝试改用createImagePicker初始化后调用：
修改你的代码：

import React, {useState} from 'react';
import {StyleSheet, Button, Image, View, Alert} from 'react-native';
import { createImagePicker, ImageLibraryOptions } from 'react-native-image-picker';

import UploadFile from '../services/UploadFile';

// 初始化ImagePicker实例
const imagePicker = createImagePicker();

export default function UploadScreen() {
  const [imageUri, setImageUri] = useState('');

  const options: ImageLibraryOptions = {
    mediaType: 'photo',
    includeBase64: false,
    selectionLimit: 1,
  };
  
  const pickImage = () => {
    // 使用实例调用launchImageLibrary
    imagePicker.launchImageLibrary(options, response => {
      if (response.didCancel) {
        console.error('User cancelled image picker');
      } else if (response.errorCode) {
        console.error('ImagePicker Error: ', response.errorMessage);
      } else if (!response.assets?.length || !response.assets[0].uri) {
        console.error('no image selected');
      } else {
        setImageUri(response.assets[0].uri);
      }
    });
  };

  // 其余代码保持不变
}

4. 检查模拟器相册权限 #

打开iOS模拟器的「设置」→「隐私与安全性」→「照片」，确认你的应用被允许访问相册。若权限被拒绝或未授权，会导致模块调用失败。

5. 重新安装依赖确保完整性 #

执行以下命令重新安装react-native-image-picker：

npm uninstall react-native-image-picker
npm install react-native-image-picker
cd ios && pod install

额外排查 #

• 打开Xcode项目，进入目标应用的Build Phases→Link Binary With Libraries，确认RNImagePicker.framework已被添加（RN 0.70+自动链接，一般无需手动操作，但可验证）；
• 尝试在iOS真机上测试，模拟器偶尔会出现权限或模块加载的特殊问题。

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