使用PDFJS渲染PDF时出现Setting up fake worker警告，该如何解决？

这个警告的意思是：PDF.js没能成功启动专用的Worker线程，只能退而求其次用「伪Worker」模式——也就是直接在页面的主线程里处理PDF的解析和渲染任务，而非启用独立的后台Worker线程。

为什么会出现这个警告？ #

你代码里虽然引入了pdf.worker.min.js，但PDF.js没正确识别到这个Worker脚本的路径，导致没法初始化真正的Worker线程，只能 fallback 到主线程处理模式。

怎么解决？ #

• 显式指定Worker路径：在调用getDocument之前，手动设置Worker脚本的地址，比如：

pdfjsLib.GlobalWorkerOptions.workerSrc = '//cdnjs.cloudflare.com/ajax/libs/pdf.js/3.0.279/pdf.worker.min.js';

• 检查路径有效性：确保Worker脚本的版本和PDF.js主库完全一致，路径没有拼写错误；如果是本地文件，注意浏览器的跨域限制（本地打开HTML时，部分浏览器会阻止加载Worker）。

这个警告有什么影响？ #

用伪Worker模式时，PDF解析、渲染这些耗时操作会占用主线程，可能导致页面卡顿、响应变慢，尤其是处理大体积或复杂PDF时更明显。启用真正的Worker线程可以把这些任务放到后台执行，不会阻塞主线程，页面流畅度会提升很多。

修正后的代码示例 #

<html>
    <head>
        <script src="//cdnjs.cloudflare.com/ajax/libs/pdf.js/3.0.279/pdf.min.js"></script>
        <script src="//cdnjs.cloudflare.com/ajax/libs/pdf.js/3.0.279/pdf.worker.min.js"></script>
    </head>
    <body>
        <canvas id="pdf"></canvas>
    </body>
    <script>
'use strict';

// 显式指定Worker脚本路径
pdfjsLib.GlobalWorkerOptions.workerSrc = '//cdnjs.cloudflare.com/ajax/libs/pdf.js/3.0.279/pdf.worker.min.js';

let pdfPath = 'https://path-to-pdf.pdf';
pdfjsLib.getDocument(pdfPath).promise.then(pdf=>{
    pdf.getPage(1).then(page=>{
        const viewport = page.getViewport({scale: 1}), canvas = document.getElementById('pdf'), context = canvas.getContext('2d');
        canvas.height = viewport.height;
        canvas.width = viewport.width;
        const renderContext = {
            canvasContext: context,
            viewport: viewport
        };
        page.render(renderContext);
    });
}).catch(err=>{
    console.error('Error: '+err);
});
    </script>
</html>

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