详解HTML中base标签在动态生成PDF时的路径解析-html教程-PHP中文网

pdf工具如wkhtmltopdf、pd4ml完全忽略标签，不执行其路径重写逻辑，而是按输入文件路径或显式指定的base url解析相对路径；浏览器中生效，但导出pdf时该标签无效。

详解html中base标签在动态生成pdf时的路径解析

wkhtmltopdf、pd4ml 等主流 HTML→PDF 工具在渲染阶段**完全忽略 <base> 标签**——它们不走浏览器的 HTML 解析器路径重写逻辑，而是直接按当前文档 URL 或显式传入的 base URL 重新计算所有相对路径。

这意味着：你在 HTML 中写了 <base href="/report/">，但用 wkhtmltopdf 直接加载本地 report.html 文件，所有 src="img/chart.png" 仍会尝试从文件所在目录拼接，而不是从 /report/ 开始找。

wkhtmltopdf 默认以输入文件路径为基准解析相对 URL（例如 wkhtmltopdf report.html out.pdf → 基准是 ./）
pd4ml 默认使用 file:// 协议 + 当前工作目录，<base> 对它无任何影响
若通过 HTTP 加载（如 wkhtmltopdf http://localhost:8080/report），则基准是该 URL，<base> 依然被跳过

启用 --enable-local-file-access 后，wkhtmltopdf 允许读取本地 file:// 资源，但它**不会把 <base href> 当作路径起点**——它只认你传入的输入路径或 URL。

常见翻车点：report.html 里有 <img src="assets/logo.png"> 和 <base href="/report/">，你执行：

wkhtmltopdf --enable-local-file-access report.html out.pdf

结果是它去找 ./assets/logo.png（当前目录下），而不是 /report/assets/logo.png。因为 <base> 在 wkhtmltopdf 的渲染流程中压根没被触发。

html-to-pptx

将多页 HTML 演示文稿转换为美化的 PPTX 文件，便于分享和分发。

下载

pd4ml 提供 PD4ML.setBaseURL(String url) 方法，但它和 HTML 中的 <base href> **毫无关系**。这个方法只是告诉 pd4ml：“所有相对路径，请以这个字符串为前缀拼接”，它不会去解析或读取 HTML 文档里的 <base> 标签。

如果你没调用 setBaseURL()，pd4ml 默认用空字符串或当前 classpath 根路径，此时 <base href="/static/"> 依然被无视。

必须显式设置：pd4ml.setBaseURL("file:///home/user/reports/static/");
若 HTML 中资源路径是 css/main.css，pd4ml 会拼成 file:///home/user/reports/static/css/main.css
注意斜杠方向：Windows 下要用 file:///C:/path/，不是 file://C:\path\