React Native中react-native-file-viewer报Cannot read property open of null错误求助

1. 确认原生模块适配Expo环境 #

• react-native-file-viewer是原生模块，Expo Go无法直接运行，必须使用自定义开发客户端或者执行expo prebuild生成原生项目后再测试。
• 检查package.json中依赖版本，确保与当前Expo SDK版本兼容（比如Expo 49+对应react-native-file-viewer >= 2.1.5）。

2. 修正导入与调用时机 #

• 检查导入方式，若默认导出异常，改用命名导入：

  import * as FileViewer from 'react-native-file-viewer';
  

• 避免在组件初始化阶段直接调用open方法，确保模块加载完成后再执行，比如绑定到按钮点击事件：

  const handleOpenFile = async () => {
    try {
      await FileViewer.open('你的文件路径');
    } catch (err) {
      console.log(err);
    }
  };
  
  // 渲染按钮
  <Button title="打开文件" onPress={handleOpenFile} />
  

3. 适配Expo文件URI格式 #

• Expo FileSystem生成的URI可能需要转换为原生路径，通过FileSystem.getInfoAsync获取nativePath后传入：

  import * as FileSystem from 'expo-file-system';
  
  const openFile = async () => {
    const targetUri = FileSystem.documentDirectory + 'test.pdf';
    const fileInfo = await FileSystem.getInfoAsync(targetUri);
    
    if (fileInfo.exists) {
      try {
        // 优先尝试nativePath，若不行再用uri
        await FileViewer.open(fileInfo.nativePath || fileInfo.uri);
      } catch (err) {
        console.error('打开失败:', err);
      }
    }
  };
  

4. 检查权限配置 #

• 在app.json中添加对应平台的权限声明：
  • Android：

    "android": {
      "permissions": ["READ_EXTERNAL_STORAGE", "WRITE_EXTERNAL_STORAGE"]
    }
    

  • iOS：

    "ios": {
      "infoPlist": {
        "NSPhotoLibraryUsageDescription": "需要访问相册以查看文件"
      }
    }
    

• 运行时主动请求权限：

  import * as Permissions from 'expo-permissions';
  
  const requestFilePermission = async () => {
    const { status } = await Permissions.askAsync(Permissions.MEDIA_LIBRARY);
    if (status !== 'granted') {
      alert('请授予文件读取权限');
    }
  };
  

5. 替代方案：使用Expo原生API #

如果react-native-file-viewer仍无法正常工作，可改用Expo官方API实现文件查看：

import * as Linking from 'expo-linking';

const openFileWithSystem = async (fileUri) => {
  const isSupported = await Linking.canOpenURL(fileUri);
  if (isSupported) {
    await Linking.openURL(fileUri);
  } else {
    alert('当前设备不支持打开该文件类型');
  }
};

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