升级至react-native 0.61.2后调用document-picker.show出现类型错误

我之前也碰到过类似的情况，RN 0.60+的自动链接偶尔会有小坑，结合你的排查经历，给你几个针对性的解决步骤：

1. 先确认包版本兼容RN 0.61.2 #

react-native-document-picker在适配RN 0.60+后有不少API和链接逻辑的调整，先检查你的package.json里的包版本。建议直接安装适配新版本的最新版：

npm install react-native-document-picker@latest --save
# 或者用yarn
yarn add react-native-document-picker@latest

2. 检查导入与调用方式是否正确 #

新版本的包已经修改了导出逻辑，别再用旧的默认导入写法，试试这样导入：

import DocumentPicker from 'react-native-document-picker';

调用时确保写法正确：

try {
  const result = await DocumentPicker.show({
    type: [DocumentPicker.types.allFiles], // 按需配置文件类型
  });
  console.log('选中的文件:', result);
} catch (err) {
  if (DocumentPicker.isCancel(err)) {
    // 用户取消选择的逻辑
  } else {
    throw err;
  }
}

3. 验证Android端自动链接是否生效 #

RN 0.60+的自动链接理论上无需手动操作，但偶尔会失效，你可以手动检查：

• 打开android/app/src/main/java/[你的包名]/MainApplication.java，确认getPackages()列表里已经自动添加了new RNPickerPackage()
• 打开android/settings.gradle，确认存在以下配置：

  include ':react-native-document-picker'
  project(':react-native-document-picker').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-document-picker/android')
  

如果没有，手动添加后重新编译。

4. 清理所有缓存后重新构建 #

缓存经常会导致这类奇怪的未定义问题，执行以下命令彻底清理：

# 清理npm/yarn缓存
npm cache clean --force
# yarn用户执行 yarn cache clean

# 重置RN缓存
react-native start --reset-cache

# 清理Android构建缓存
cd android && ./gradlew clean
cd .. && react-native run-android

5. 确认Android权限配置 #

检查android/app/src/main/AndroidManifest.xml是否添加了文件读取权限：

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

如果需要保存文件，还需添加WRITE_EXTERNAL_STORAGE权限。

6. 确保是全新构建APK #

有时候卸载旧APK后，构建仍会复用缓存，建议手动删除android/app/build文件夹，再执行react-native run-android，确保生成的是全新的安装包。

如果以上步骤都试过还是不行，可以删除node_modules文件夹，重新执行npm install/yarn install，再重复缓存清理和构建流程。

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