<embed> 标签嵌入 PDF 失败主因是 CORS 配置缺失、type="application/pdf" 未声明及移动端 Safari 不支持；需服务端设置 Access-Control-Allow-Origin、确保 Content-Type 正确，并优先用 <iframe> 或 PDF.js 兼容处理。

<embed> 标签确实能快速把 PDF 嵌入网页，但实际用起来经常白屏、报错或根本不加载——根本原因不是写法错了，而是浏览器策略和 PDF 服务端配置没对上。

PDF 文件必须支持跨域（CORS），否则 Chrome/Firefox 直接拒绝加载

本地双击 HTML 打开时，<embed src="xxx.pdf"> 看似能工作，但一旦部署到服务器（哪怕 localhost:8080），90% 的失败都源于 PDF 响应头缺失 Access-Control-Allow-Origin。

• 检查方法：打开 DevTools → Network → 点击 PDF 请求 → 查看 Response Headers 是否含 Access-Control-Allow-Origin: * 或对应域名
• Nginx 配置示例：add_header 'Access-Control-Allow-Origin' '*';（开发环境可用，生产请限定域名）
• Apache 需启用 mod_headers 并加 Header set Access-Control-Allow-Origin "*"
• 静态托管平台（如 GitHub Pages、Vercel）默认不支持添加响应头，此时 <embed> 基本不可用

<embed> 的 type 属性不是可选的，必须显式声明 application/pdf

省略 type 或写成 text/pdf、pdf 等非标准值，会导致 Safari 完全不渲染，Edge 回退为下载链接。

• 正确写法：<embed src="manual.pdf" type="application/pdf" width="100%" height="600px">
• 不要依赖 MIME 自动识别：浏览器不会主动探测 PDF 文件头来补全类型
• 如果后端返回的 PDF 响应头中 Content-Type 不是 application/pdf，<embed> 也会失效（即使 type 属性写对了）

移动端 Safari 和部分安卓 WebView 完全忽略 <embed>，必须降级处理

iOS 上无论你怎么配，<embed> 在 Safari 中大概率显示为空白或提示“无法预览”。这不是 bug，是 Apple 明确不支持内联 PDF 渲染（只允许通过 <iframe> 调用系统预览）。

• 兼容方案：优先用 <iframe src="xxx.pdf">，它在 iOS 上会触发系统 PDF 查看器
• 但注意：<iframe> 同样受 CORS 限制；若 PDF 不同源且无响应头，会显示空白或 404
• 更稳妥的做法是服务端生成带 token 的直链，或用 PDF.js 做纯前端解析（避开所有跨域和浏览器限制）

真正卡住人的从来不是怎么写那一行 <embed>，而是搞不清请求路径是否被代理重写、PDF 是否被 CDN 缓存了旧响应头、或者开发机上测试正常上线就崩——这些细节不逐层验证，光调标签属性没用。