Amazon EC2部署Node.js应用失败，疑似phantomjs依赖下载问题

1. 定位引入phantomjs的依赖 #

你的package.json中，pdf-creator-node@2.3.4是引入phantomjs的根源——这个库内部依赖phantomjs-prebuilt来生成PDF，和node-cron无关（node-cron仅用于定时任务，不涉及PDF渲染或phantomjs）。

你可以通过以下命令验证：

npm ls phantomjs

执行后会显示完整依赖链，确认是pdf-creator-node间接引入了phantomjs。

2. 部署失败核心原因 #

phantomjs已停止维护，官方下载源不稳定，再加上EC2实例可能存在网络访问限制，导致部署时无法下载对应的二进制包，最终触发部署失败。

3. 修复方案 #

方案一：替换镜像源加速下载 #

在EC2部署流程中，添加phantomjs的镜像源环境变量，或者在项目根目录创建.npmrc文件：

phantomjs_cdnurl=https://npm.taobao.org/mirrors/phantomjs

部署时先设置环境变量再执行安装：

export PHANTOMJS_CDNURL=https://npm.taobao.org/mirrors/phantomjs && npm install

方案二：替换PDF生成库 #

由于pdf-creator-node依赖的phantomjs已停止维护，建议替换为更稳定的替代方案，比如：

• html-pdf-node：基于维护活跃的puppeteer，语法和pdf-creator-node接近，迁移成本低
• pdfkit：原生Node.js PDF生成库，无需依赖外部二进制文件

方案三：检查EC2网络权限 #

确认EC2实例的安全组、NACL规则允许出站访问HTTPS（443端口），确保能连接到phantomjs的下载源（如github.com、npm.taobao.org等）。

方案四：清理缓存重新安装 #

部署前清理npm缓存，避免缓存的损坏文件导致安装失败：

npm cache clean --force && rm -rf node_modules package-lock.json && npm install

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