x-frame-options 已被现代浏览器逐步弃用,应优先使用 content-security-policy 的 frame-ancestors 指令替代;仅当需兼容 ie10/11 等旧浏览器时,才可将其作为兜底方案。

X-Frame-Options 是防止点击劫持(Clickjacking)最直接有效的 HTTP 响应头之一,但它的作用范围有限——仅支持 deny、sameorigin 和已废弃的 allow-from,且现代浏览器已逐步弃用它。如果你还在单独依赖 X-Frame-Options 来防护,大概率会漏掉关键场景。
为什么只设 X-Frame-Options 不够用
Chrome、Firefox、Edge 等主流浏览器自 2020 年起已默认忽略 X-Frame-Options(当存在 Content-Security-Policy 的 frame-ancestors 指令时),后者才是当前 W3C 推荐的标准方案。单独设置 X-Frame-Options 在以下情况会失效:
- 目标页面同时配置了
Content-Security-Policy: frame-ancestors ...—— 浏览器优先执行 CSP 规则,X-Frame-Options被静默丢弃 - 需要允许特定外部域名嵌入(如 SaaS 嵌入白名单),
allow-from在 Chrome 46+、Firefox 76+ 已完全不生效 - 使用 iframe 加载跨源资源时,
sameorigin会直接阻止所有非同源嵌入,包括合法的微前端或嵌入式仪表盘
正确做法:用 frame-ancestors 替代 X-Frame-Options
在响应头中设置 Content-Security-Policy: frame-ancestors 'none' 等价于 X-Frame-Options: DENY,但更可靠、可扩展。常见配置如下:
Content-Security-Policy: frame-ancestors 'none'
禁止任何嵌入;
Content-Security-Policy: frame-ancestors 'self'
仅允许同源嵌入(等价于 X-Frame-Options: SAMEORIGIN);
Content-Security-Policy: frame-ancestors https://trusted.example.com https://app.company.com
明确放行多个可信来源(allow-from 做不到这点)。
注意:'self' 后不能跟路径(如 'self'/dashboard),也不支持通配符(https://*.example.com)——必须写完整协议 + 域名。
兼容旧浏览器时要不要保留 X-Frame-Options?
要,但仅作为兜底。IE10/11、老版 Safari(
X-Frame-Options: DENY Content-Security-Policy: frame-ancestors 'none'
顺序无关紧要,浏览器各自按支持度解析。但注意两点:
- 不要在同一个响应里混用
frame-ancestors 'self'和X-Frame-Options: SAMEORIGIN—— 虽不报错,但语义重复且增加维护负担 - 若后端框架(如 Spring Security、Django)自动注入
X-Frame-Options,需显式关闭它,再统一用 CSP 控制,否则可能冲突
验证是否生效的实操检查点
打开 DevTools → Network → 刷一次页面 → 找到 HTML 响应头,确认:
- 存在
Content-Security-Policy且含frame-ancestors字段(不是拼错成frame-ancestor或frame-src) - 没有出现
Refused to display 'xxx' in a frame because an ancestor violates the following Content Security Policy directive这类错误(说明策略已触发) - 用一个空白 HTML 文件写
<iframe src="your-site.com"></iframe>实测加载行为是否符合预期
最容易被忽略的是开发环境本地服务(如 localhost:3000)常被误设为 'self',结果导致测试时 iframe 正常,上线后因协议/端口/子域差异突然失败。










