CORS失败主因是服务端未配置响应头,而非前端代码错误;fetch/axios跨域本质相同,需后端返回Access-Control-Allow-Origin等头,带凭证时不能用*;开发阶段推荐代理,禁用JSONP。

直接用 fetch 发请求,但 90% 失败是因为没配服务端 CORS
浏览器拦你不是因为你代码写错了,而是服务端没声明“允许谁来调我”。fetch 本身完全支持跨域,但一旦发起带凭证(如 cookies)或非简单请求(如带自定义 header),浏览器就会先发一个 OPTIONS 预检请求——如果后端没返回 Access-Control-Allow-Origin 等头,就直接报 CORS error。
常见错误现象:
-
Failed to fetch或Network Error(控制台 Network 标签里能看到 status 0) - 预检请求返回 404 或 502,且 Response Headers 里没有
Access-Control-Allow-Origin - 带
credentials: 'include'时,Access-Control-Allow-Origin: *会被浏览器拒绝
实操建议:
- 确认目标 API 是否本就支持 CORS:用 curl 或 Postman 直接请求,看响应头有没有
Access-Control-Allow-Origin - 若你控制后端,至少加这三行响应头:
Access-Control-Allow-Origin: https://your-domain.com(别用*配 credentials)、Access-Control-Allow-Methods: GET, POST、Access-Control-Allow-Headers: Content-Type - 若只是本地开发调试,用浏览器插件(如 Moesif Origin CORS Changer)临时绕过——但别当生产方案
axios 跨域失败,和原生 fetch 本质一样
axios 是封装层,它不解决跨域,只是让发请求更方便。你看到的 axios.get(...) 报错,根源和 fetch 完全一致:还是服务端没回正确 CORS 头。
立即学习“前端免费学习笔记(深入)”;
容易踩的坑:
- 误以为加
axios.defaults.withCredentials = true就能跨域登录——其实它只让浏览器带上 cookie,反而要求后端必须指定精确的Access-Control-Allow-Origin(不能是*) - 在
axios.interceptors.request里加 header(比如X-Auth-Token),触发了预检,但后端没在Access-Control-Allow-Headers里声明它 - 用 CDN 引入
axios后直接调用,却忘了检查控制台 Network 里的 actual request 是不是 200——很多失败其实是 401/403,不是跨域
实操建议:
- 先关掉所有拦截器和自定义配置,用最简写法测试:
axios.get('https://api.example.com/data') - 打开浏览器 DevTools → Network → 点开那个失败的请求 → 查看 Headers → Response Headers → 确认是否有
Access-Control-Allow-Origin - 如果只是想快速验证数据结构,把 API 地址粘到浏览器地址栏直访问——能打开 JSON 就说明服务端没拦你,问题出在前端调用方式或域名配置上
真要绕过 CORS?优先选代理,别碰 JSONP
JSONP 是历史包袱:只支持 GET、无法捕获错误、回调函数名暴露在全局、服务端必须专门支持。2026 年还用它,等于主动放弃错误处理、超时控制和 Promise 链式操作。
现代替代方案只有两个靠谱选择:
-
开发阶段用本地代理:比如 vite.config.js 里配
server.proxy,把/api前缀转发到目标域名。浏览器认为这是同源请求,CORS 自动消失 -
上线后用反向代理(Nginx):把
https://your.com/api/xxx映射到https://third-party.com/xxx,所有请求走你自己的域名,彻底规避浏览器跨域检查
注意点:
- 代理只解决“前端发请求”这一步,不改变鉴权逻辑。token 还得你自己从 localStorage 读、手动塞进 header
- 如果你用的是纯静态 HTML(无构建工具),那就没法配 dev server 代理——只能换方案:要么说服后端开 CORS,要么自己搭个轻量 Node 代理(几行
express+http-proxy-middleware)
iframe + postMessage 不是网络请求,别混淆用途
有人看到“跨域通信”就想到 postMessage,但它和 AJAX 完全是两回事:postMessage 是让两个已加载的页面(比如父页 + iframe 子页)互相传字符串或简单对象,不涉及 HTTP 请求、不走网络、不拿远程数据。
典型误用场景:
- 想用
postMessage去“调用”第三方 API——不行,API 在服务器上,你得先发 HTTP 请求拿到结果,再用postMessage把结果传给 iframe - 在 iframe 里加载
https://api.xxx.com/data.json——浏览器会直接拦截,因为iframe的 src 必须是 HTML 页面,不是 JSON 接口 - 以为
postMessage能绕过 CORS 获取图片或脚本——它连网络都不碰,根本没机会触发跨域检查
真正该用它的场合:
- 嵌入第三方 SDK(比如支付弹窗、客服 widget),它们提供自己的 JS SDK,内部用
postMessage和你的主站通信 - 微前端架构中,基座应用和子应用跨域隔离,靠
postMessage同步用户登录态或路由变化
最后提醒一句:所有“绕过 CORS”的方案,本质都是让浏览器认为请求是同源的。真正的跨域限制不在前端代码里,而在 HTTP 协议层和浏览器安全模型中——这点不理解,调三天也白搭。



















