Node.js+Express(EJS)项目中pdfjs-dist的getDocument函数失效问题

1. 环境不匹配：Node端模块无法直接在浏览器使用 #

pdfjs-dist的核心API（包括getDocument）是为浏览器环境设计的，依赖浏览器的fetch、Canvas API等特性。你通过res.locals传递的是Node.js端的pdfjsLib模块，这个模块在浏览器中无法正常工作——它的底层实现是针对Node环境的，和浏览器端的PDF.js不是同一套运行逻辑。

解决办法：

• 直接在EJS视图中通过CDN引入浏览器版的PDF.js，比如：

  <script src="https://cdnjs.cloudflare.com/ajax/libs/pdf.js/4.0.379/pdf.min.js"></script>
  <script>
    // 直接使用全局的pdfjsLib对象
    pdfjsLib.getDocument('path/to/your.pdf').promise.then(doc => {
      // 处理文档逻辑
    }).catch(err => {
      console.error('加载失败:', err);
    });
  </script>
  

• 或者通过前端构建工具（如Webpack）打包浏览器版的pdfjs-dist，而非从Node端传递模块。

2. PDF资源路径错误 #

如果传递给getDocument的是服务器本地的绝对路径（比如/home/user/docs/test.pdf），浏览器无法直接访问服务器文件系统里的资源。必须使用浏览器可访问的URL：

• 将PDF文件放在Express的静态资源目录（比如public/pdf），然后用相对路径或完整URL，例如：

  pdfjsLib.getDocument('/pdf/test.pdf').promise.then(...)
  

3. 未处理Promise错误 #

你的代码可能没有捕获getDocument返回的Promise的错误，导致错误被静默，看起来像是“无响应”。一定要添加catch块排查问题：

pdfjsLib.getDocument('your-pdf-url')
  .promise
  .then(doc => {
    console.log('文档加载成功:', doc.numPages);
  })
  .catch(err => {
    console.error('PDF加载失败详情:', err); // 这里会输出具体错误原因
  });

4. 缺少Worker配置 #

PDF.js需要Worker线程来解析PDF，浏览器版的PDF.js默认会自动加载Worker脚本，但如果是自定义引入的，可能需要手动指定workerSrc：

pdfjsLib.GlobalWorkerOptions.workerSrc = 'https://cdnjs.cloudflare.com/ajax/libs/pdf.js/4.0.379/pdf.worker.min.js';
// 然后再调用getDocument
pdfjsLib.getDocument('your-pdf-url').promise.then(...);

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