iframe加载失败时，先查Network面板状态码是否为404/403或预检失败，再看Elements中iframe下有无#document子树；本地file://协议需启服务，注意同源三要素（协议+域名+端口）严格匹配，跨域禁止访问contentDocument，须用postMessage通信并校验origin。
iframe加载失败时，先看Network和Elements面板
白屏但控制台没报错？别猜逻辑问题，直接打开开发者工具的 Network 面板，过滤 iframe 请求，确认状态码是不是 404、403 或预检失败；再切到 Elements 面板，点开 iframe 标签，看它底下有没有生成 #document 子树——没有就说明压根没加载成功。
常见漏点：
- 本地开发用
file://协议打开 HTML，src="page.html"会因协议限制被浏览器静默拒绝，必须起本地服务（如python3 -m http.server 8000） - 单页应用中写
src="about.html"，但路由没透传，服务端返回 404 - 目标页面响应头含
X-Frame-Options: DENY或Content-Security-Policy: frame-ancestors 'none'，直接拦截
同源调试要确保协议、域名、端口三者完全一致
同源不是“看起来一样”，而是协议+域名+端口三者严格匹配。比如 http://localhost:5000 和 https://localhost:5000 不同源，http://127.0.0.1:5000 和 http://localhost:5000 也不同源——哪怕它们指向同一服务。
实操建议：
立即学习“前端免费学习笔记（深入）”；
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur
- 本地调试优先用 VS Code Live Server 插件，它固定生成
http://127.0.0.1:xxxx/地址，避免localhost和 IP 混用 - 不要在开发环境混用
http和https，哪怕只是临时测试，也容易触发混合内容警告或跨域拦截 - 检查子页面
<base href="/">是否存在，它会影响内部相对路径解析，导致 CSS/JS 404
跨域 iframe 里调不到 contentDocument 是正常现象
这不是 bug，是浏览器强制安全策略：Blocked a frame from accessing a cross-origin frame 这类错误出现，说明你试图读取不同源 iframe 的 DOM，浏览器立刻抛出 DOMException。
能做的只有两件事：
- 改用
postMessage通信：父页发消息，子页监听message事件并响应，且必须校验event.origin完全匹配（包括端口） - 子页面自己管理样式和行为：父页无法注入 CSS 或执行 JS，所有视觉和交互逻辑必须由子页自主实现
- 如果真需要 DOM 级联动（如滚动同步），得双方约定好 message 类型和 payload 结构，靠消息驱动，而不是直接操作
多级嵌套 iframe 通信必须手动中转，不能依赖自动透传
父页 → 子 iframe → 孙 iframe，浏览器不会把 postMessage 自动往下传。子 iframe 收到消息后，若不显式调用 grandChildIframe.contentWindow.postMessage()，孙 iframe 就收不到。
关键细节：
- 每层都得提前注册
window.addEventListener('message', ...)，放在<script></script>内联脚本里最稳妥，避免错过首条消息 - 转发时
targetOrigin必须填孙 iframe 的实际源，不是父页或子 iframe 的源 -
event.source是发送方窗口，不是“上一级”——不能靠它原路返回，得缓存可信的contentWindow引用 - 动态创建的 iframe 要等
load事件后再发消息，否则contentWindow是null
document.write，或 <base> 设置错误，或 referrerpolicy 导致资源请求被截断——这些都不会报明显错误，但会让 iframe 表现异常。调试时得一层层剥开，从网络请求开始，而不是一上来就改 JS 逻辑。 
