html-pdf库在Heroku服务器无法生成PDF的问题求助

错误原因 #

这个报错源于html-pdf依赖的PhantomJS在Heroku环境中无法完成自动配置：

• Heroku默认运行环境缺少PhantomJS所需的底层系统依赖库
• 本地配置的base路径（file:///开头）在Heroku的临时文件系统中无法被正确解析

解决方案 #

1. 补充PhantomJS的系统依赖 #

通过Heroku buildpack安装PhantomJS及其依赖，执行以下CLI命令：

heroku buildpacks:add --index 1 https://github.com/heroku/heroku-buildpack-phantomjs.git
heroku buildpacks:add --index 2 heroku/nodejs

该操作会先安装PhantomJS相关依赖，再部署Node.js应用。

2. 调整html-pdf的配置 #

移除配置中与本地路径绑定的base选项，因为Heroku的文件系统结构和本地存在差异，修改后的配置示例：

let options = {
  "format": 'A4'
};

3. 替换为维护活跃的PDF生成库 #

html-pdf已停止维护，推荐使用puppeteer替代，适配Heroku环境的代码示例：

const puppeteer = require('puppeteer');
const path = require('path');

// ... 其他业务代码 ...

ejs.renderFile(path.join(__dirname, "../views/111.ejs"), {report1data : airtableData}, async (err, data) => {
  if (err) {
    console.log("error line 210"+err);
  } else {
    // 启动无头浏览器，适配Heroku环境参数
    const browser = await puppeteer.launch({
      args: ['--no-sandbox', '--disable-setuid-sandbox']
    });
    const page = await browser.newPage();
    await page.setContent(data);
    // 生成PDF
    const pdfBuffer = await page.pdf({ format: 'A4' });
    await browser.close();

    // 响应下载
    res.setHeader('Content-Type', 'application/pdf');
    res.setHeader('Content-Disposition', `attachment; filename=${filename}`);
    res.send(pdfBuffer);
  }
});

使用puppeteer时需要添加对应的buildpack：

heroku buildpacks:add --index 1 https://github.com/jontewks/puppeteer-heroku-buildpack.git
heroku buildpacks:add --index 2 heroku/nodejs

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