17370845950

HTML转PDF链接失效通常因服务、接口或前端逻辑中断，需分三类排查：一是window.print()伪链接，手动Ctrl+P导出；二是后端API失效，检查Network中404、401或CORS错误；三是jsPDF等本地渲染失败，验证DOM选择器与异步加载。

HTML 转 PDF 的链接失效，通常不是“链接被删了”这么简单，而是背后依赖的服务、接口或前端逻辑断了。直接刷新或重试没用，得看它用的是哪种转换方式。

检查是否用了 window.print() 伪造“转PDF”

很多网页所谓“转PDF”，其实只是加了个按钮触发 window.print()，靠浏览器自身打印功能导出。这种“链接”本质是 JS 事件，不是真实 URL —— 所以点不动、右键打不开、Network 里也看不到请求。

• 打开开发者工具（F12），点击该按钮，看 Console 是否报错：Uncaught ReferenceError: print is not defined 或类似
• 在 Elements 面板中找到按钮元素，查看 onclick 属性或绑定的事件监听器，确认是否调用 window.print()
• 如果是，那就没有“链接”可恢复——只需手动按 Ctrl+P（Win）或 Cmd+P（Mac），选择“保存为 PDF”目标打印机即可

排查后端 API 接口是否 404 或 CORS 拒绝

真有后端服务生成 PDF 的，常见于企业系统（如用 /api/export/pdf 接口）。链接失效往往因为：

• 接口路径被改写（比如从 /export 升级为 /v2/export），旧按钮仍调用老地址
• 登录态过期，接口返回 401 Unauthorized，但前端没提示，按钮看起来“点了没反应”
• 跨域限制：若前端部署在 https://a.com，却请求 https://b.com/api/pdf，而后者没配 Access-Control-Allow-Origin，请求会在 Network 中显示 Blocked by CORS Policy

实操建议：

• 在 Network 标签页过滤 pdf 或 export，点击按钮后观察是否有失败请求
• 点开失败请求，看 Response 标签页内容：是空？是 HTML 登录页？还是 JSON 错误？比如 {"error":"token expired"}
• 如果是 token 过期，尝试刷新页面重新登录；如果是路径错误，可尝试把 URL 中的 /export 替换为 /api/export/pdf 手动访问（注意带 cookie）

确认是否依赖第三方 SDK（如 jsPDF、html2canvas）本地渲染

有些页面用 jsPDF + html2canvas 在浏览器里截图转 PDF。这类方案不发请求，但极易因 DOM 变化失效：

• 页面结构更新（比如把 改成
  ），而 JS 仍试图抓取旧 ID
• 异步内容未加载完就执行截图，结果 PDF 是空白或缺内

  

  容
• 新版 Chrome 对 canvas 跨域图片拦截更严，若 HTML 含外链图片且没加 crossOrigin="anonymous"，html2canvas 会静默失败

验证方法：

• 在 Console 执行 typeof html2canvas 和 typeof jsPDF，确认变量存在
• 手动运行截图逻辑，例如：

  html2canvas(document.querySelector("#content")).then(canvas => { new jsPDF().addImage(canvas.toDataURL("image/png"), "PNG", 0, 0); });

• 若报错 TypeError: Cannot read property 'style' of null，说明 querySelector 没找到目标节点 —— 得去源码里查当前实际容器选择器

真正难恢复的，是那种把转换逻辑和权限校验、水印生成、模板引擎全耦合在后端的私有服务——链接失效往往意味着整个模块已被下线或重构。这时候翻 F12 看 Network 不如直接查 Git 历史或问当初写的同事：那个 /pdf/generate 接口，现在挪到哪儿了？