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
实操建议：
Nextjs App Router Audit
下载
审查 Next.js App Router 代码库，检查 React Server Component 边界错误、请求瀑布、客户端/服务端反模式以及 Core Web Vitals 风险...
立即学习“前端免费学习笔记（深入）”；
- 在 Network 标签页过滤
pdf或export，点击按钮后观察是否有失败请求 - 点开失败请求，看
Response标签页内容：是空？是 HTML 登录页？还是 JSON 错误？比如{"error":"token expired"} - 如果是 token 过期，尝试刷新页面重新登录；如果是路径错误，可尝试把 URL 中的
/export替换为/api/export/pdf手动访问（注意带 cookie）
确认是否依赖第三方 SDK（如 jsPDF、html2canvas）本地渲染
有些页面用 jsPDF + html2canvas 在浏览器里截图转 PDF。这类方案不发请求，但极易因 DOM 变化失效：
- 页面结构更新（比如把
<div id="content"> 改成 <code><main class="doc"></main>），而 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 接口，现在挪到哪儿了？
