PDF工具如wkhtmltopdf、pd4ml完全忽略<base>标签，不执行其路径重写逻辑，而是按输入文件路径或显式指定的base URL解析相对路径；浏览器中<base>生效，但导出PDF时该标签无效。
PDF工具解析HTML时根本不读base标签
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>依然被跳过
wkhtmltopdf 的 --enable-local-file-access 和路径基准冲突
启用 --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 的渲染流程中压根没被触发。
- 解决方法：用
--load-error-handling ignore配合绝对路径或file://URL 显式写死资源引用 - 更可靠做法：在生成 PDF 前，用脚本把 HTML 中所有相对
src/href替换为file:///full/path/to/... - 避免依赖
<base>做 PDF 路径管理——它在这里就是个摆设
pd4ml 的 PD4ML.setHtmlWidth() 和 base URL 是两回事
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\
动态生成 PDF 时，<base> 只对浏览器预览有效，对导出无效
你在页面里加 <base href="/pdf-assets/">，用户在浏览器里点“打印为 PDF”能正常加载图片和样式，是因为浏览器真正在用这个标签；但一旦交给 wkhtmltopdf 或 pd4ml 这类后端工具处理，这个标签就彻底失效。
本质区别在于：浏览器渲染是“先解析 <base>，再重写所有相对路径”，而 PDF 工具是“绕过解析，直接按自己规则 resolve 路径”。两者路径解析引擎完全不同。
- 最易被忽略的点：开发时用浏览器打印预览一切正常，上线后用 wkhtmltopdf 批量导出全 404 —— 就是因为混用了两个路径体系
- 统一方案：构建时用 Webpack/Vite 的
public目录 + 绝对路径引用，或导出前用正则批量替换 HTML 中的相对路径 - 别指望
<base>在 PDF 流水线里起作用，它只活在浏览器的 HTML 解析阶段
