Electron打包后electron-pdf-window无法在Win8.1打开PDF窗口求助

我之前也碰到过类似的Electron打包后PDF窗口无法显示的问题，结合你描述的场景——开发正常、Windows 8.1打包后失效，大概率是版本兼容、路径或者打包配置的问题，给你几个具体的排查和解决思路：

1. 优先检查Electron版本兼容性 #

Windows 8.1从Electron 21版本开始就不再被官方支持了！如果你的项目用的是Electron 21及以上版本，打包后在Windows 8.1上运行会出现各种兼容性问题，包括第三方组件（比如electron-pdf-window）无法正常工作。

解决办法：

• 降级Electron到20.x系列的稳定版本（比如20.3.8），同时确保electron-pdf-window的版本和降级后的Electron兼容。
• 执行命令：

  npm install electron@20.3.8 --save-dev
  

2. 修正PDF文件的路径问题 #

开发时的相对路径在打包后会失效，因为Electron打包后资源会被封装到app.asar或者单独的resources目录，路径指向完全不同。

两种常见场景的路径处理： #

• 如果PDF是打包进应用的内置资源：
  用Electron提供的app.getAppPath()或者process.resourcesPath来拼接绝对路径，比如：

  const path = require('path');
  const { app } = require('electron');
  // 假设PDF放在项目根目录的docs文件夹下
  const pdfAbsolutePath = path.join(app.getAppPath(), 'docs', 'target.pdf');
  

  同时要确保打包工具（比如electron-builder）把这个目录打包进去，在package.json的build配置里添加：

  "build": {
    "extraResources": [
      {
        "from": "./docs/",
        "to": "docs/"
      }
    ]
  }
  

• 如果PDF是用户上传/外部文件：
  不要用相对路径，而是用app.getPath('userData')来指定存储目录，这个路径是系统分配给应用的安全存储位置，不会受打包影响：

  const pdfSavePath = path.join(app.getPath('userData'), 'user_upload.pdf');
  

3. 排查权限问题 #

Windows 8.1的UAC权限限制可能导致应用无法读取文件或者创建窗口，试试以下操作：

• 右键点击打包后的exe，选择「以管理员身份运行」，如果PDF窗口能正常显示，说明需要配置应用默认请求管理员权限。
• 在electron-builder的package.json配置里添加：

  "build": {
    "win": {
      "requestedExecutionLevel": "highestAvailable"
    }
  }
  

4. 调试打包后的错误信息 #

打包后看不到控制台日志，所以需要把错误信息写入日志文件来定位问题：
在主进程里添加全局错误捕获和日志写入：

const fs = require('fs');
const path = require('path');
const { app } = require('electron');

const logFilePath = path.join(app.getPath('userData'), 'app_error.log');

// 捕获未处理的异常
process.on('uncaughtException', (error) => {
  const logContent = `[${new Date().toISOString()}] 未处理异常: ${error.message}\n${error.stack}\n\n`;
  fs.appendFileSync(logFilePath, logContent);
});

// 在调用electron-pdf-window的地方添加try-catch
try {
  const pdfWindow = require('electron-pdf-window');
  const win = pdfWindow.createWindow({ width: 800, height: 600 });
  win.loadURL(pdfAbsolutePath);
} catch (error) {
  const logContent = `[${new Date().toISOString()}] PDF窗口创建失败: ${error.message}\n${error.stack}\n\n`;
  fs.appendFileSync(logFilePath, logContent);
}

安装应用后，去C:\Users\<你的用户名>\AppData\Roaming\<应用名称>下找到app_error.log，查看具体的错误原因（比如路径不存在、组件加载失败等）。

5. 替换为Electron原生PDF查看方式 #

如果electron-pdf-window在Windows 8.1上确实有兼容问题，可以直接用Electron内置的Chromium内核来查看PDF，不需要依赖第三方组件：

const { BrowserWindow } = require('electron');

// 创建普通BrowserWindow加载PDF
const pdfWin = new BrowserWindow({ width: 800, height: 600 });
// 注意要把路径转成file://协议格式
pdfWin.loadURL(`file://${encodeURIComponent(pdfAbsolutePath)}`);

这种方式兼容性更好，因为Chromium本身支持PDF渲染，不需要额外组件。

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