PDF嵌入空白或404主因是路径错误或服务器未正确托管，需确保src为HTML相对有效路径、type="application/pdf"、用本地服务器预览，并检查Network面板响应状态与MIME类型。
PDF嵌入后空白或报错404
直接用 标签时，最常见问题是路径写错或PDF未被服务器正确托管。浏览器不会提示“文件不存在”，而是静默显示空白区域或 fallback 内容。
- 确保 PDF 文件路径是**相对当前 HTML 的有效路径**，比如 PDF 在同级目录就写
src="manual.pdf"；若在/assets/docs/下，必须写src="/assets/docs/manual.pdf"（注意开头的/表示根路径） - 检查浏览器开发者工具的 Network 面板，确认 PDF 请求返回的是
200 OK且Content-Type是application/pdf；如果返回404或text/html，说明路径错或服务器没配 MIME 类型 - 本地双击打开 HTML 时，
file://协议下多数浏览器会因安全策略阻止加载 PDF，务必用本地服务器（如python3 -m http.server）预览
Embed 标签的 src 和 type 必须同时正确
能否渲染 PDF 不只看 src，还依赖 type 属性是否声明为 application/pdf。漏掉它，部分浏览器（尤其是旧版 Safari 或 Edge）会忽略该资源或降级为下载链接。
- 最小可用写法：
<embed src="doc.pdf" type="application/pdf" width="100%" height="600px"></embed>
-
width和height推荐用具体数值（如800px）或百分比，避免设为auto—— 多数浏览器不支持height="auto"，会导致高度塌陷 - 不要混用
和嵌套：虽然有些教程这么写，但现代浏览器中纯更可靠；容易触发下载而非预览，尤其在 Chrome 95+ 后
iFrame 替代方案更稳定但有跨域限制
当 在某些环境（如企业内网、HTTPS 页面加载 HTTP PDF）失效时， 是更兼容的选择，但它对跨域 PDF 有严格限制：若 PDF 来自不同源且未设置 Access-Control-Allow-Origin，iframe 会白屏且控制台报 CORS 错误。
- 同域 PDF 可直接用：
<iframe src="report.pdf" width="100%" height="600px" frameborder="0"></iframe>
- Google Docs Viewer 是绕过 CORS 的常用兜底方案（但需联网）：
<iframe src="https://docs.google.com/gview?url=https://yoursite.com/doc.pdf&embedded=true" width="100%" height="600px"></iframe>
注意：PDF URL 必须可公网访问，且 Google 可能缓存旧版本 - 移动端 Safari 对
支持极差，iOS 用户基本只能看到下载按钮；+ Google Viewer 是目前最稳妥的跨端方案
PDF 文件本身影响加载行为
不是所有 PDF 都适合直接嵌入。浏览器 PDF 查看器（如 Chromium 内置的 PDFium）对加密、XFA 表单、高版本 PDF（如 PDF 2.0）、或含 JavaScript 的文档支持有限，轻则渲染异常，重则完全拒绝加载。
- 用
pdfinfo（Linux/macOS）或在线工具检查 PDF 版本和特性：pdfinfo document.pdf | grep -E "(PDF|Encrypted|Form)"
若输出含Encrypted: yes或XFA: yes，需先转成普通 PDF（如用 Adobe Acrobat “另存为” 兼容版本） - 超过 50MB 的 PDF 在嵌入时容易卡顿甚至中断加载；建议前端加 loading 提示，并后端启用 gzip 压缩（Nginx 中配置
gzip_types application/pdf;） - 中文乱码？大概率是 PDF 内嵌字体缺失或未正确子集化；优先用由 Word / LaTeX 导出的 PDF，避免截图转 PDF 或扫描件直传
实际嵌入前，先用 curl 检查 PDF 是否可直取：curl -I https://yoursite.com/doc.pdf，确认响应头含 Content-Type: application/pdf 和 Content-Length 非零。这步省掉，后面调半天样式都白搭。
