embed标签在2026年已不可靠，仅限内网老环境临时使用；现代项目应优先采用iframe或pdf.js，因safari和移动端禁用第三方mime类型渲染、不支持noembed回退、跨平台行为不一致且排查困难。
embed 标签在 2026 年已不是可靠方案，仅限内网老环境临时使用；现代项目应优先用 iframe 或 pdf.js。
为什么 embed 在 Safari 和移动端基本失效
Safari（macOS 14+ / iOS）从底层禁用第三方 MIME 类型渲染，即使 src 和 type="application/pdf" 都正确，也只显示空白或下载按钮。Chrome 和 Edge 虽能渲染，但行为不一致：Firefox 默认关闭内置 PDF 查看器（需手动设 pdfjs.disabled = false），embed 无法触发回退内容，控制台也无报错，排查困难。
-
embed不支持noembed回退逻辑——浏览器直接忽略其中的提示文字 - 移动端 Android Chrome、iOS Safari 对
embed的 PDF 渲染支持为“名义存在”，实际多数场景降级为下载 - 即使本地路径写对、服务器返回 200，Safari Network 面板中 PDF 请求的
Content-Type仍可能被覆盖为text/html，导致静默失败
embed 能跑起来的三个硬条件缺一不可
若你仍在内网 IE11 或定制 Chromium 环境中维护旧系统，embed 最小可用写法必须同时满足：
-
src必须是同源 HTTP/HTTPS URL，file://协议双击打开 HTML 会因安全策略被拦截 -
type必须严格为"application/pdf"；写成"pdf"、"application/x-pdf"或漏掉，都会导致 Chrome 下载、Safari 白屏 -
width和height必须是具体值（如800px或100%），height="auto"在所有主流浏览器中均无效，高度塌陷
验证方式：打开开发者工具 → Network 面板 → 找到 PDF 请求 → 确认状态码为 200 且响应头含 Content-Type: application/pdf。
用 iframe 替代 embed 更稳定，但要注意跨域和参数
iframe src="doc.pdf" 是当前最轻量、兼容性更好的替代方案，它调用的是浏览器原生 PDF 查看器（PDFium），无需额外 JS：
- 同源 PDF 可直接加载：
<iframe src="report.pdf" width="100%" height="600px" frameborder="0"></iframe> - 隐藏工具栏可加 URL 参数：
report.pdf#toolbar=0&navpanes=0&scrollbar=0 - 跨域 PDF 必须服务端返回
Access-Control-Allow-Origin: *，否则 iframe 白屏且控制台无 CORS 报错（只在 Network 面板显示空响应） - 国内环境慎用 Google Docs Viewer：
https://docs.google.com/gview?url=...因其不可访问，且要求 PDF 公网可抓取、URL 编码严格
pdf.js 是唯一真正可控的方案，但配置不能省
当需要翻页、搜索、缩放、批注或处理加密 PDF 时，pdf.js 是唯一选择——它用 Canvas 渲染，不依赖浏览器插件：
- 必须托管完整目录：至少包含
pdf.min.js和pdf.worker.min.js，且 worker 路径需显式配置（PDFJS.workerSrc = 'pdf.worker.min.js'） - 服务端必须返回
Content-Type: application/pdf，Nginx/Apache 需补 MIME 类型配置，否则解析直接失败 - 大文件建议启用流式加载：
PDFJS.disableStream = false，并配合 loading 提示 - 移动端需额外处理手势：默认不支持双指缩放，需自己监听
touchstart/touchmove并调用page.render()重绘
真正容易被忽略的是：PDF 文件本身是否结构优化——未压缩、含大量嵌入字体或高分辨率图像的 PDF，在低端设备上首次渲染可能卡顿数秒，这不是代码问题，而是字节流解析成本。
