Node.js引入pdfreader模块报错：Cannot read property 'userAgent' of undefined

我之前也碰到过一模一样的问题！pdfreader依赖的pdf2json模块在Express环境下会因为缺失浏览器环境的全局变量而报错，尤其是userAgent这个属性。这里有几个实用的解决办法：

方法1：注入全局navigator变量 #

在你的Express应用入口文件（比如app.js）最顶部添加这段代码，为Node.js环境补上缺失的浏览器全局对象：

global.navigator = { userAgent: 'node' };

这样pdf2json在执行eval逻辑时就能找到navigator.userAgent，不会再抛出未定义的错误。

方法2：临时设置全局变量后恢复 #

如果不想长期污染全局环境，可以在引入pdfreader之前临时设置navigator，加载完成后再恢复原状：

// 保存原全局navigator（如果有的话）
const originalNavigator = global.navigator;
// 临时注入浏览器环境模拟变量
global.navigator = { userAgent: 'node' };
// 加载pdfreader模块
const pdfreader = require('pdfreader');
// 恢复原全局变量
global.navigator = originalNavigator;

方法3：更新依赖版本 #

这类兼容性问题有时候是旧版本的bug导致的，试试把pdfreader和它的依赖pdf2json更新到最新版：

npm update pdfreader pdf2json

新版本可能已经针对Node.js环境做了兼容性修复，不需要手动注入全局变量。

问题原因说明 #

pdfreader的底层依赖pdf2json原本是为浏览器环境设计的，它的部分代码会尝试通过navigator.userAgent判断运行环境。但在Node.js（尤其是Express应用）的全局环境中，默认不存在navigator对象，所以当模块加载时就会抛出Cannot read property 'userAgent' of undefined的错误。而你单独运行node sandbox/pdf.js时，可能因为代码结构简单、没有其他模块干扰，没触发这个环境检测逻辑，所以能正常运行。

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