使用react-native-pdf-lib创建PDF报getDocumentsDirectory相关TypeError求解决方案

该报错本质是JS层无法访问到react-native-pdf-lib对应的原生模块导出对象，不属于业务逻辑错误，常见触发原因：

• 依赖安装后未完成原生关联流程，库未被打包进原生安装包
• 开发环境为无自定义原生能力的Expo托管模式，不支持该库运行
• iOS端未执行CocoaPods依赖安装步骤，原生二进制未链接到Xcode工程
• 库版本与当前React Native版本不兼容，原生导出对象匹配失败
• 模块初始化时序异常，在原生绑定完成前就提前调用了模块方法

按优先级依次操作即可解决：

1. 完成原生依赖全链路配置
   • 若使用React Native 0.60以下版本，手动执行react-native link react-native-pdf-lib完成模块关联
   • 若使用0.60及以上自动链接版本，执行全量重装流程：

     # 清空依赖缓存重新安装
     rm -rf node_modules && yarn install
     # 进入iOS目录安装原生pod依赖
     cd ios && pod install
     

   • 配置完成后必须完全终止App后台进程，重新编译安装debug包，不能直接依赖热更新加载旧的原生二进制
2. 开发环境适配校验
   • 若当前为Expo托管开发模式，该库不支持无自定义原生配置的托管环境，需将工程转换为带原生目录的裸工程后再做配置
   • 若使用React Native 0.65以上新架构版本，需升级react-native-pdf-lib到最新稳定版，旧版本对新架构的原生绑定存在兼容缺陷
3. 修正代码初始化时序
   调整模块实例化顺序，避免提前调用未完成绑定的模块方法：

   // 正确的导入写法
   import PDFLib, { PDFDocument, PDFPage } from 'react-native-pdf-lib';
   
   const handleCreatePdf = async () => {
     try {
       // 将PDFPage的实例化移到函数内部，避开模块初始化时序问题
       const page1 = PDFPage.create()
         .setMediaBox(200, 200)
         .drawText('You can add text and rectangles to the PDF!', {
           x: 5,
           y: 235,
           color: '#007386',
         })
         .drawRectangle({
           x: 25,
           y: 25,
           width: 150,
           height: 150,
           color: '#FF99CC',
         })
         .drawRectangle({
           x: 75,
           y: 75,
           width: 50,
           height: 50,
           color: '#99FFCC',
         });
   
       const docsDir = await PDFLib.getDocumentsDirectory();
       const pdfPath = `${docsDir}/ex.pdf`;
       PDFDocument.create(pdfPath)
         .addPages(page1)
         .write()
         .then(path => {
           console.log('PDF created at: ' + path);
         })
         .catch(err => console.log(err));
     } catch (error) {
       console.log(error);
     }
   };
   

4. 兜底路径校验
   若上述配置全部完成后仍报空对象错误，可通过第三方文件库获取文档目录做校验，排查是否为单个原生方法绑定异常：

   import RNFS from 'react-native-fs';
   // 替换原库自带的目录获取逻辑
   const docsDir = RNFS.DocumentDirectoryPath;
   

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