网页被 iframe 嵌入时报 X-Frame-Options 拒绝显示怎么解决

现象:iframe 一片空白,控制台报拒绝显示

把合作方的页面嵌进自己的 iframe,框架区域全白。打开控制台能看到 Refused to display 'https://...' in a frame because it set 'X-Frame-Options' to 'deny',直接访问该地址却完全正常。

原因:目标页面禁止被框架嵌套

这是防点击劫持的安全头,默认策略就是拒绝。常见于三种配置:

  • 响应头写死 X-Frame-Options: DENY,任何页面都不允许嵌;
  • 写成 SAMEORIGIN,只有同源页面能嵌,跨域一律被拒;
  • 用 CSP 的 frame-ancestors 限制,优先级比 X-Frame-Options 更高,改 XFO 也没用。

解决步骤

第一步,先看实际返回的头,同时确认有没有 CSP:

curl -I https://合作方域名/page

第二步,按业务决定放开范围。如果只有同源需要嵌,保留 SAMEORIGIN 即可;如果必须允许指定站点,X-Frame-Options 只支持单个值,改用 CSP 更灵活:

add_header Content-Security-Policy \
  "frame-ancestors 'self' https://www.你的域名" always;

第三步,注意 add_header 的继承规则。只要 location 块里出现了任意一个 add_header,上层的头就不会再继承,很容易出现"server 里配了但页面没有"的情况,检查时以实际响应为准。

第四步,缓存问题。响应头通常跟着页面一起缓存,改完要刷新 CDN 和浏览器缓存,否则复测看到的还是旧头。

小结

先 curl 看头再改配置。同源用 SAMEORIGIN,多域名白名单用 CSP 的 frame-ancestors,两者同时存在时以 CSP 为准,改完记得清缓存复测。

还要注意一个方向问题:真正决定"谁能嵌我"的是被嵌页面的响应头,iframe 所在页面改任何属性都无效,sandbox 属性只会进一步限制而不是放开。如果是第三方页面拒绝嵌入,只能请对方调整,或者在服务端抓取内容再渲染,直接前端绕过既不安全也不可靠。排查时把 curl 拿到的头和浏览器控制台报错对照,能立刻判断是 XFO 还是 CSP 在起作用。

您可以还会对下面的文章感兴趣: