AWS环境下Nightmare JS导出PDF：部分端口可用，生产环境导出空白PDF

我之前碰到过类似的NightmareJS在生产环境导出空白PDF的问题，结合你的场景，大概率是这几个方向出了问题，给你梳理下排查和解决思路：

1. XVFB环境配置差异 #

测试环境和生产环境的XVFB配置可能存在差异，比如显示分辨率、颜色深度设置不足，导致Nightmare渲染页面时无法正常生成内容。

• 排查方法：在生产环境手动启动XVFB（比如执行Xvfb :1 -screen 0 1280x1024x24），然后在这个环境下手动运行你的导出脚本，看是否能生成正常PDF。
• 解决办法：确保子进程调用XVFB时指定足够的分辨率和颜色深度，比如把启动命令改成Xvfb :1 -screen 0 1920x1080x24，避免因画布尺寸或颜色深度不够导致渲染失败。

2. 页面加载时机未把控好 #

生产环境的网络速度、页面加载逻辑和测试环境有差异，Nightmare可能在财务数据还没完全异步加载、页面未渲染完成时就触发了PDF导出。

• 排查方法：在导出脚本中临时加入截图逻辑（.screenshot('test.png')），查看生成的截图是否有完整的财务数据，以此判断是否是加载时机问题。
• 解决办法：不要依赖固定延迟，改为等待特定DOM元素出现或者监听页面的自定义事件来确认内容完全渲染。比如：

nightmare
  .goto('/export')
  .wait('#financial-data-table') // 等待财务数据表格加载完成
  .wait(1500) // 额外短延迟确保渲染稳定
  .pdf('exported.pdf')
  .end()

3. 生产环境资源访问受限 #

生产环境可能存在防火墙、权限或CDN缓存问题，导致页面依赖的静态资源（如CSS、数字字体）加载失败，页面渲染异常最终生成空白PDF。

• 排查方法：用Nightmare的截图功能查看页面渲染状态，如果截图显示样式错乱或内容缺失，就说明是资源加载问题。
• 解决办法：检查生产服务器是否能访问所有页面依赖的资源，尤其是财务数据用到的字体文件，必要时将字体文件打包到应用目录，使用本地路径引用。

4. 子进程权限不足 #

生产环境运行Node.js的用户可能没有读写临时文件的权限，或者XVFB的运行权限不足，导致PDF生成后无法正确读取或发送。

• 排查方法：查看服务器日志，是否有EACCES这类权限相关的报错信息。
• 解决办法：确保运行Node进程的用户对临时文件目录（如/tmp）有读写权限，或者指定一个有权限的目录来存放生成的PDF文件。

5. 依赖版本不一致 #

测试环境和生产环境的NightmareJS、Electron版本不一致，导致渲染行为存在差异。

• 排查方法：对比测试和生产环境的package.json及锁文件（package-lock.json/yarn.lock），确认依赖版本完全一致。
• 解决办法：使用锁文件锁定依赖版本，部署生产环境时严格按照锁文件安装依赖，避免版本差异引发的问题。

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