跨域问题及多种解决方法

跨域是什么

这里的“跨域”指的是不同源之间的资源访问。只要请求的 url 有以下不同，都属于“跨域”：

• 协议: http, https, …
• 域名
• 端口

为什么会有跨域

这种“跨域”限制其实是 浏览器自带的安全机制，只有在浏览器上发生跨域请求操作时，浏览器就会自动抛出上面的错误。

注意，这仅在浏览器上会出现这样的限制，如果你用 Postman 这些工具访问 url 是没有“跨域”限制的，毕竟 Postman 连域名这些玩意都没有，哪来的“跨域”。

如何解决跨域

JSONP

JSONP原理

那对于浏览器不支持 CORS 的情况呢?虽然目前来看是不太可能，但是在还没有 CORS 的时代，大家是怎么解决跨域的呢?答案就是 JSONP。

它的原理也非常简单：虽然浏览器限制了 HTTP 的跨域，但是没有限制获取 script 标签内容的跨域请求呀。

当我们插入一个 <script src="xxx.com"> 标签的时候，会发一个获取 xxx.com 的 GET 请求，而这个 GET 请求又不存在“跨域”限制，通过这样的方法就能解决跨域的问题了。

当调用 jsonp 函数的时候，自动创建一个 script 标签，再把请求放到 src 里，就会自动发起 GET 请求。服务端会直接返回一串 JavaScript 代码，然后前端执行这段从服务端获取来的 JS 代码，获取到后端数据。JSONP请求一定需要对方的服务器做支持才可以。

JSONP与Ajax

JSONP和AJAX相同，都是客户端向服务器端发送请求，从服务器端获取数据的方式。但AJAX属于同源策略，JSONP属于非同源策略（跨域请求）

JSONP优缺点

JSONP优点是简单兼容性好，可用于解决主流浏览器的跨域数据访问的问题。缺点是仅支持get方法具有局限性,不安全可能会遭受XSS攻击。

JSONP的实现流程

• 声明一个回调函数，其函数名(如show)当做参数值，要传递给跨域请求数据的服务器，函数形参为要获取目标数据(服务器返回的data)。
• 创建一个<script>标签，把那个跨域的API数据接口地址，赋值给script的src,还要在这个地址中向服务器传递该函数名（可以通过问号传参:?callback=show）。
• 服务器接收到请求后，需要进行特殊的处理：把传递进来的函数名和它需要给你的数据拼接成一个字符串,例如：传递进去的函数名是show，它准备好的数据是show('我不爱你')。
• 最后服务器把准备的数据通过HTTP协议返回给客户端，客户端再调用执行之前声明的回调函数（show），对返回的数据进行操作。

在开发中可能会遇到多个 JSONP 请求的回调函数名是相同的，这时候就需要自己封装一个 JSONP函数。

// index.html
function jsonp({ url, params, callback }) {
  return new Promise((resolve, reject) => {
    let script = document.createElement('script')
    window[callback] = function(data) {
      resolve(data)
      document.body.removeChild(script)
    }
    // script.onload=()=>{
    // script.remove();
    //}
    params = { ...params, callback } // wd=b&callback=show
    let arrs = []
    for (let key in params) {
      arrs.push(`${key}=${params[key]}`)
    }
    script.src = `${url}?${arrs.join('&')}`
    document.body.appendChild(script)
  })
}
jsonp({
  url: 'http://localhost:3000/say',
  params: { wd: 'Iloveyou' },
  callback: 'show'
}).then(data => {
  console.log(data)
})

上面这段代码相当于向http://localhost:3000/say?wd=Iloveyou&callback=show这个地址请求数据，然后后台返回show('我不爱你')，最后会运行show()这个函数，打印出’我不爱你’

// server.js
let express = require('express')
let app = express()
app.get('/say', function(req, res) {
  let { wd, callback } = req.query
  console.log(wd) // Iloveyou
  console.log(callback) // show
  res.end(`${callback}('我不爱你')`)
})
app.listen(3000)

jQuery的jsonp形式

JSONP都是GET和异步请求的，不存在其他的请求方式和同步请求，且jQuery默认就会给JSONP的请求清除缓存。

$.ajax({
url:"http://crossdomain.com/jsonServerResponse",
dataType:"jsonp",
type:"get",//可以省略
jsonpCallback:"show",//->自定义传递给服务器的函数名，而不是使用jQuery自动生成的，可省略
jsonp:"callback",//->把传递函数名的那个形参callback，可省略
success:function (data){
console.log(data);}
});

CORS

虽然浏览器出于安全考虑做了“跨域”访问的限制，但开发时不可避免会有这样不同源资源访问的需求，因此 W3C 就制定了 CORS(Cross-origin resource sharing 跨域资源共享) 的机制。

很多人一直以为 CORS = 跨域，其实 CORS 是一种解决“跨域”的方案。

需要注意的是，CORS 是一个“新”的协议(至少对于以前的 IE7 是新的)，不仅需要浏览器支持，也后端服务器的支持。E8 和 9 需要通过 XDomainRequest 来实现。

浏览器支持没什么好说的，就是浏览器版本是否支持的问题。

然后就是后端服务器支持了，服务器需要在 Response Header 上添加 Access-Control-xxx-yyy 的字段，浏览器识别到了，才能放行该请求。比如，最常见的就是加 Access-Control-Allow-Origin 这个返回头，值设置为需要放行的域名。该属性表示哪些域名可以访问资源，如果设置通配符则表示所有网站都可以访问资源。

简单请求和非简单请求（复杂请求）

我们在开发网站时经常会用到跨域资源共享（简称cors）来解决跨域问题，但是在使用cors的时候，http请求会被划分为两类，简单请求和复杂请求，而这两种请求的区别主要在于是否会触发cors预检请求。

浏览器将 CORS 请求分为 简单请求 和 复杂请求。

#简单请求 会在发送时自动在 HTTP 请求头加上 Origin 字段，来标明当前是哪个源(协议+域名+端口)，服务端来决定是否放行。

#非简单请求 则会先发一个 OPTIONS 预检请求给服务端，当通过了再发正常的 CORS 请求。

对于简单请求，请求方法为以下三种之一：

• Head
• Post
• Get

且 HTTP 请求头字段不能超过以下字段：

• Accept
• Accept-Language
• Content-Language
• Last-Event-ID
• Content-Type

同时Content-Type 只能三个值：

• application/x-www-form-urlencoded 对应普通表单
• multipart/form-data 对应文件上传
• text/plain 对应文本发送(一般不怎么用)

请求中的任意 XMLHttpRequestUpload 对象均没有注册任何事件监听器； XMLHttpRequestUpload 对象可以使用 XMLHttpRequest.upload 属性访问。

请求中没有使用 ReadableStream 对象。

只要不满足上面条件的，都属于非简单请求。

可能很多人会自然地觉得 POST 请求都是 非简单请求，因为我们常看到发 POST 时，都会先发 OPTIONS。其实是因为我们一般都会传 JSON 格式的数据，Content-Type 为 application/json，所以，这样的 POST 请求才属于 非简单请求。

我们用PUT向后台请求时，属于复杂请求，后台需做如下配置：

// 允许哪个方法访问我
res.setHeader('Access-Control-Allow-Methods', 'PUT')
// 预检的存活时间
res.setHeader('Access-Control-Max-Age', 6)
// OPTIONS请求不做任何处理
if (req.method === 'OPTIONS') {
  res.end() 
}
// 定义后台返回的内容
app.put('/getData', function(req, res) {
  console.log(req.headers)
  res.end('我不爱你')
})

接下来我们看下一个完整复杂请求的例子，并且介绍下CORS请求相关的字段

// index.html
let xhr = new XMLHttpRequest()
document.cookie = 'name=xiamen' // cookie不能跨域
xhr.withCredentials = true // 前端设置是否带cookie
xhr.open('PUT', 'http://localhost:4000/getData', true)
xhr.setRequestHeader('name', 'xiamen')
xhr.onreadystatechange = function() {
  if (xhr.readyState === 4) {
    if ((xhr.status >= 200 && xhr.status < 300) || xhr.status === 304) {
      console.log(xhr.response)
      //得到响应头，后台需设置Access-Control-Expose-Headers
      console.log(xhr.getResponseHeader('name'))
    }
  }
}
xhr.send()

//server1.js
let express = require('express');
let app = express();
app.use(express.static(__dirname));
app.listen(3000);

//server2.js
let express = require('express')
let app = express()
let whitList = ['http://localhost:3000'] //设置白名单
app.use(function(req, res, next) {
  let origin = req.headers.origin
  if (whitList.includes(origin)) {
    // 设置哪个源可以访问我
    res.setHeader('Access-Control-Allow-Origin', origin)
    // 允许携带哪个头访问我
    res.setHeader('Access-Control-Allow-Headers', 'name')
    // 允许哪个方法访问我
    res.setHeader('Access-Control-Allow-Methods', 'PUT')
    // 允许携带cookie
    res.setHeader('Access-Control-Allow-Credentials', true)
    // 预检的存活时间
    res.setHeader('Access-Control-Max-Age', 6)
    // 允许返回的头
    res.setHeader('Access-Control-Expose-Headers', 'name')
    if (req.method === 'OPTIONS') {
      res.end() // OPTIONS请求不做任何处理
    }
  }
  next()
})
app.put('/getData', function(req, res) {
  console.log(req.headers)
  res.setHeader('name', 'jw') //返回一个响应头，后台需设置
  res.end('我不爱你')
})
app.get('/getData', function(req, res) {
  console.log(req.headers)
  res.end('我不爱你')
})
app.use(express.static(__dirname))
app.listen(4000)

上述代码由http://localhost:3000/index.html向http://localhost:4000/跨域请求，正如我们上面所说的，后端是实现 CORS 通信的关键。

Access-Control-xxx-yyy

当 CORS 请求为 简单请求时，请求会检测返回头里的以下字段：

• Access-Control-Allow-Origin：指定哪些源是可以共享资源的(包含协议、域名、端口)。
• Access-Control-Allow-Credentials：当请求需要携带 Cookie 时，需要加上这个字段为 true 才能允许携带 Cookie。
• Access-Control-Expose-Headers：由于 XMLHttpRequest 对象只能拿到 Cache-Control、Content-Language、Content-Type、Expires、Last-Modified、Pragma 这 6 个基本字段。想要在拿到别的字段，就需要在这里去指定。

而当 CORS 请求为非简单请求时，浏览器会先发一个 OPTIONS 预检(preflight)请求，这个请求会检查如下字段：

• Access-Control-Request-Method：指定可访问的方法，对于非简单请求，可能会用到 PUT，PATCH，DELETE 等 RESTful 方法，服务端需要把这些方法名也加上。
• Access-Control-Request-Headers：指定 HTTP 请求头会额外添加的信息。一个很常见的场景就是，后端有时候会将一些环境参数放到请求头里，如果不用这个字段来指定放行的字段，那么就会出现“跨域”限制了。

如果 OPTIONS 请求没有通过服务端的校验，就会返回一个正常的 HTTP 请求，不会带上 CORS 的返回信息，所以浏览器就会认定为“跨域”了。

总结一句话就是，当 Console 报哪个错，你就在服务端返回头上加上哪个字段就可以了。

CORS中间件

无论对于 Express 还是 KOA，我们都不需要再手动添加上面的字段了，直接加一个 cors 中间件就可以很方便地添加上面的字段，写起来也更优雅：

var cors = require('cors'); 
 
var corsOptions = { 
  origin: function (origin, callback) { 
    // db.loadOrigins is an example call to load 
    // a list of origins from a backing database 
    db.loadOrigins(function (error, origins) { 
      callback(error, origins) 
    }) 
  } 
} 
 
app.use('/', cors(corsOptions), indexRouter); 

配置代理解决跨域

自己配置代理服务器(nodejs+express)

// 1. 安装所需依赖
// npm install express http-proxy-middleware cors

const express = require('express');
const { createProxyMiddleware } = require('http-proxy-middleware');
const cors = require('cors');

const app = express();

// 2. 处理跨域（可选）
app.use(cors());

// 3. 配置代理规则
app.use(
  '/api', // 前端请求路径前缀
  createProxyMiddleware({
    target: 'http://backend-server.com', // 目标服务器地址
    changeOrigin: true, // 修改请求头中的Host值
    pathRewrite: {
      '^/api': '', // 路径重写（去掉前缀）
    },
    onProxyRes: (proxyRes) => {
      // 可选：添加CORS响应头
      proxyRes.headers['Access-Control-Allow-Origin'] = '*';
    }
  })
);

// 4. 启动服务器
app.listen(3000, () => {
  console.log('Proxy server running on http://localhost:3000');
});

前端调用：

fetch('http://localhost:3000/api/data') // 请求代理服务器

使用nginx搭建代理服务器

# nginx.conf 配置片段
server {
    listen 80;
    server_name localhost;

    location / {
        root   /usr/share/nginx/html;
        index  index.html;
    }

    # 代理配置
    location /api/ {
        proxy_pass http://backend-server.com/;  # 目标服务器地址
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        
        # 处理跨域
        add_header 'Access-Control-Allow-Origin' '*' always;
        add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS';
        add_header 'Access-Control-Allow-Headers' 'DNT,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Range';
    }
}

操作步骤：

1. 修改配置文件后保存
2. 检查配置：nginx -t
3. 重启服务：nginx -s reload

借助脚手架搭建服务器

// 方法1：package.json 配置
{
  "name": "react-app",
  "version": "1.0.0",
  "proxy": "http://backend-server.com" // 简单代理配置
}

// 方法2：自定义代理（创建 src/setupProxy.js）
const { createProxyMiddleware } = require('http-proxy-middleware');

module.exports = function(app) {
  app.use(
    '/api',
    createProxyMiddleware({
      target: 'http://backend-server.com',
      changeOrigin: true,
      pathRewrite: {
        '^/api': '',
      }
    })
  );
};

前端调用：

// 开发环境下直接请求相对路径
fetch('/api/data') // 会被代理到 http://backend-server.com/data

方案对比

方案	适用场景	优势	注意事项
自建Node代理	开发/测试环境	灵活定制代理逻辑	需要维护Node服务
Nginx代理	生产环境	高性能，支持负载均衡	需要服务器运维知识
脚手架代理	前端开发环境	零配置、开箱即用	仅限开发环境使用

---

工作原理

代理服务器通过以下机制解决跨域：

1. 请求转发：浏览器 → 代理服务器 → 目标服务器
2. 同源规避：浏览器与代理服务器同源（如都是localhost）
3. 头信息处理：修改请求头Host和响应头CORS

---

常见问题排查

1. 确保代理服务器已正确启动
2. 检查代理路径是否匹配（特别是pathRewrite配置）
3. 查看浏览器开发者工具中的Network标签：
   • 确认请求实际发送到了代理地址
   • 检查响应头是否包含Access-Control-Allow-Origin: *
4. 生产环境需确保Nginx配置已重新加载（nginx -s reload）

iframe解决跨域

window.name + iframe

window.name属性的独特之处：name值在不同的页面（甚至不同域名）加载后依旧存在，并且可以支持非常长的 name 值（2MB）。

其中a.html和b.html是同域的，都是http://localhost:3000;而c.html是http://localhost:4000

 // a.html(http://localhost:3000/b.html)
  <iframe src="http://localhost:4000/c.html" frameborder="0" onload="load()" id="iframe"></iframe>
  <script>
    let first = true
    // onload事件会触发2次，第1次加载跨域页，并留存数据于window.name
    function load() {
      if(first){
      // 第1次onload(跨域页)成功后，切换到同域代理页面
        let iframe = document.getElementById('iframe');
        iframe.src = 'http://localhost:3000/b.html';
        first = false;
      }else{
      // 第2次onload(同域b.html页)成功后，读取同域window.name中数据
        console.log(iframe.contentWindow.name);
      }
    }
  </script>

b.html为中间代理页，与a.html同域，内容为空。

 // c.html(http://localhost:4000/c.html)
  <script>
    window.name = '我不爱你'  
  </script>

通过iframe的src属性由外域转向本地域，跨域数据即由iframe的window.name从外域传递到本地域。这个就巧妙地绕过了浏览器的跨域访问限制，但同时它又是安全操作。

location.hash + iframe

实现原理： a.html欲与c.html跨域相互通信，通过中间页b.html来实现。 三个页面，不同域之间利用iframe的location.hash传值，相同域之间直接js访问来通信。

具体实现步骤：一开始a.html给c.html传一个hash值，然后c.html收到hash值后，再把hash值传递给b.html，最后b.html将结果放到a.html的hash值中。 同样的，a.html和b.html是同域的，都是http://localhost:3000;而c.html是http://localhost:4000

 // a.html
  <iframe src="http://localhost:4000/c.html#iloveyou"></iframe>
  <script>
    window.onhashchange = function () { //检测hash的变化
      console.log(location.hash);
    }
  </script>

 // b.html
  <script>
    window.parent.parent.location.hash = location.hash 
    //b.html将结果放到a.html的hash值中，b.html可通过parent.parent访问a.html页面
  </script>

 // c.html
 console.log(location.hash);
  let iframe = document.createElement('iframe');
  iframe.src = 'http://localhost:3000/b.html#idontloveyou';
  document.body.appendChild(iframe);

document.domain + iframe

该方式只能用于二级域名相同的情况下，比如 a.test.com 和 b.test.com 适用于该方式。 只需要给页面添加 document.domain ='test.com' 表示二级域名都相同就可以实现跨域。

实现原理：两个页面都通过js强制设置document.domain为基础主域，就实现了同域。

我们看个例子：页面a.zf1.cn:3000/a.html获取页面b.zf1.cn:3000/b.html中a的值

  // a.html
<body>
 helloa
  <iframe src="http://b.zf1.cn:3000/b.html" frameborder="0" onload="load()" id="frame"></iframe>
  <script>
    document.domain = 'zf1.cn'
    function load() {
      console.log(frame.contentWindow.a);
    }
  </script>
</body>

// b.html
<body>
   hellob
   <script>
     document.domain = 'zf1.cn'
     var a = 100;
   </script>
</body>

postMessage

postMessage是HTML5 XMLHttpRequest Level 2中的API，且是为数不多可以跨域操作的window属性之一，它可用于解决以下方面的问题：

• 页面和其打开的新窗口的数据传递
• 多窗口之间消息传递
• 页面与嵌套的iframe消息传递
• 上面三个场景的跨域数据传递

postMessage()方法允许来自不同源的脚本采用异步方式进行有限的通信，可以实现跨文本档、多窗口、跨域消息传递。

otherWindow.postMessage(message, targetOrigin, [transfer]);

• message: 将要发送到其他 window的数据。
• targetOrigin:通过窗口的origin属性来指定哪些窗口能接收到消息事件，其值可以是字符串"*"（表示无限制）或者一个URI。在发送消息的时候，如果目标窗口的协议、主机地址或端口这三者的任意一项不匹配targetOrigin提供的值，那么消息就不会被发送；只有三者完全匹配，消息才会被发送。
• transfer(可选)：是一串和message 同时传递的 Transferable 对象. 这些对象的所有权将被转移给消息的接收方，而发送一方将不再保有所有权。

接下来我们看个例子： http://localhost:3000/a.html页面向http://localhost:4000/b.html传递“我爱你”,然后后者传回"我不爱你"。

// a.html
  <iframe src="http://localhost:4000/b.html" frameborder="0" id="frame" onload="load()"></iframe> //等它加载完触发一个事件
  //内嵌在http://localhost:3000/a.html
    <script>
      function load() {
        let frame = document.getElementById('frame')
        frame.contentWindow.postMessage('我爱你', 'http://localhost:4000') //发送数据
        window.onmessage = function(e) { //接受返回数据
          console.log(e.data) //我不爱你
        }
      }
    </script>

// b.html
  window.onmessage = function(e) {
    console.log(e.data) //我爱你
    e.source.postMessage('我不爱你', e.origin)
 }

websocket

Websocket是HTML5的一个持久化的协议，它实现了浏览器与服务器的全双工通信，同时也是跨域的一种解决方案。WebSocket和HTTP都是应用层协议，都基于 TCP 协议。但是 WebSocket 是一种双向通信协议，在建立连接之后，WebSocket 的 server 与 client 都能主动向对方发送或接收数据。同时，WebSocket 在建立连接时需要借助 HTTP 协议，连接建立好了之后 client 与 server 之间的双向通信就与 HTTP 无关了。

原生WebSocket API使用起来不太方便，我们使用Socket.io，它很好地封装了webSocket接口，提供了更简单、灵活的接口，也对不支持webSocket的浏览器提供了向下兼容。

我们先来看个例子：本地文件socket.html向localhost:3000发送数据和接受数据

// socket.html
<script>
    let socket = new WebSocket('ws://localhost:3000');
    socket.onopen = function () {
      socket.send('我爱你');//向服务器发送数据
    }
    socket.onmessage = function (e) {
      console.log(e.data);//接收服务器返回的数据
    }
</script>

// server.js
let express = require('express');
let app = express();
let WebSocket = require('ws');//记得安装ws
let wss = new WebSocket.Server({port:3000});
wss.on('connection',function(ws) {
  ws.on('message', function (data) {
    console.log(data);
    ws.send('我不爱你')
  });
})

跨域出现场景

第一：如果是协议和端口造成的跨域问题“前台”是无能为力的。

第二：在跨域问题上，仅仅是通过“URL的首部”来识别而不会根据域名对应的IP地址是否相同来判断。“URL的首部”可以理解为“协议, 域名和端口必须匹配”。

• 前端访问跨域 URL，最常见的场景，需要后端添加 cors 的返回字段
• 微前端：主应用和子应用之间的资源访问可能存在“跨域”操作，需要子应用/主应用添加 cors
• 登录重定向：本质上和第一条一样，不过在现象层面不太一样。比如访问 abc.com 时，有的网站会重定向到自己的登录页 passport.abc.com，如果 passport.abc.com 没有设置 cors，也会出现跨域

总结

总的来说，我们常说的“跨域”，其实就是获取不同源（协议+域名+端口）的资源时，浏览器自身做出的限制。

在以前，开发者会用JSONP 这种通过生成一个 script 标签，自动发起 GET 请求的方式来解决跨域，但是这种方式非常不安全，不推荐。

到了现在，浏览器都已经完美支持 CORS 机制了，只需要在服务端添加对应的返回头 Access-Control-xxx-yyy 就可以了。当浏览器报“跨域”错误时，缺哪个字段，就在服务端配哪个字段即可。

Node 端开发时，我们可以直接使用 cors 中间件来配置，就不用手写返回头里的字段了。

• CORS支持所有类型的HTTP请求，是跨域HTTP请求的根本解决方案
• JSONP只支持GET请求，JSONP的优势在于支持老式浏览器，以及可以向不支持CORS的网站请求数据。
• 不管是自己配置代理服务器还是通过nginx、脚手架搭建代理服务器，主要是通过同源策略对服务器不加限制。
• 日常工作中，用得比较多的跨域方案是cors和nginx反向代理