Node.js使用html-pdf-node生成PDF时CSS与图片未正常渲染
问题根因
html-pdf-node 底层基于无头Chrome完成PDF渲染,出现样式、图片加载失败的核心原因有两点:
- 当传入参数为
{ content: html }(直接传入HTML字符串而非本地文件路径)时,无头浏览器没有可参考的本地文件路径基准,无法解析HTML中../css/style.css、../images/logo.png这类相对路径引用 - 无头浏览器默认禁止从直接传入的HTML内容加载本地文件资源,且默认等待资源加载的时长过短,远程CDN资源尚未下载完成就触发了PDF生成流程
可落地的修复方案
1. 调整PDF生成配置
在生成PDF的options中加入本地资源访问权限、资源等待时长配置,从根源解决加载拦截、加载超时问题:
let options = { format: 'A4', // 放开本地文件加载的安全拦截 args: ['--allow-file-access-from-files', '--disable-web-security'], // 等待所有静态资源加载完成1s后再生成PDF,避免远程资源加载不完整 waitFor: 1000 };
2. 转换相对路径为可识别的绝对路径
读取HTML模板后,将所有基于模板文件位置的相对路径,替换为无头Chrome可正常识别的file://协议绝对路径:
// 定义模板文件的绝对路径 const templateAbsPath = path.resolve(__dirname, "../path/to/template.html"); // 读取模板内容 let template = fs.readFileSync(templateAbsPath, 'utf8'); // 基于模板文件所在目录,替换所有相对路径为绝对file路径 const htmlWithAbsPath = template // 替换CSS引用的相对路径 .replace(/href="\.\.\/([^"]+)"/g, (match, relativePath) => { const absFilePath = path.resolve(path.dirname(templateAbsPath), relativePath); return `href="file://${absFilePath}"`; }) // 替换图片引用的相对路径 .replace(/src="\.\.\/([^"]+)"/g, (match, relativePath) => { const absFilePath = path.resolve(path.dirname(templateAbsPath), relativePath); return `src="file://${absFilePath}"`; });
3. 高兼容性方案:全量静态资源内联
对稳定性要求更高的场景,可直接将本地静态资源内联到HTML字符串中,完全规避路径解析问题:
- 读取本地CSS文件内容,替换原HTML中的CSS链接标签为内联
<style>标签 - 读取本地图片文件内容,转成base64格式的Data URI,替换原HTML中图片的相对路径src
示例代码:
// 读取本地CSS内容内联 const styleContent = fs.readFileSync(path.resolve(__dirname, "../css/style.css"), 'utf8'); const inlinedCss = template.replace( '<link rel="stylesheet" type=\'text/css\' href="../css/style.css">', `<style>${styleContent}</style>` ); // 读取本地图片转base64内联 const logoBuffer = fs.readFileSync(path.resolve(__dirname, "../images/logo.png")); const logoBase64Uri = `data:image/png;base64,${logoBuffer.toString('base64')}`; const finalHtml = inlinedCss.replace( '<img src="../images/logo.png"', `<img src="${logoBase64Uri}"` );
排错提示
- 如果调整后仍存在加载异常,可在options中加入
debug: true参数,开启调试模式:PDF生成流程结束后无头Chrome不会自动关闭,可直接查看渲染页面的控制台报错、资源404情况,定位具体缺失的资源地址 - 如果是内网无公网权限的环境,需要将引入的公共CDN CSS(如示例中的bootstrap样式表)下载到本地,以上述内联方式引入,避免远程资源加载失败
内容的提问来源于stack exchange,提问作者Paul Digz
相关产品推荐
相关产品推荐

