前端跨域解决方案详解:从原理到九种实现方式

作者:阿沐

时间:2026-10-31

浏览:132

本文深入解析浏览器同源策略限制,详细阐述跨域产生的原因及广义与狭义定义。重点介绍九种常见的前端跨域解决方案,包括JSONP、document.domain、location.hash、window.name、postMessage、CORS、Nginx代理、Node.js中间件代理及WebSocket协议,并提供各方案的具体实现代码与适用场景分析。

文章目录

跨域概念解析

跨域指的是在一个域下的文档或脚本尝试请求另一个域下的资源。这里所指的跨域是广义上的概念,涵盖了多种资源交互场景。

广义跨域范畴

  • 资源跳转行为:包括A标签链接、页面重定向以及表单提交等操作。
  • 资源嵌入方式:涉及link、script、img、frame等DOM标签的使用,以及CSS样式中的background:url()和@font-face()等文件外链加载。
  • 脚本发起的请求:涵盖JavaScript发起的Ajax请求,以及DOM和JavaScript对象之间的跨域操作。

通常我们讨论的跨域问题,特指由“浏览器同源策略限制”所引发的一类请求场景。

同源策略定义

同源策略(Same Origin Policy,简称SOP)是一项由Netscape公司于1995年引入浏览器的约定,它是浏览器核心且最基本的安全功能。若缺乏同源策略,浏览器极易遭受XSS(跨站脚本攻击)和CSRF(跨站请求伪造)等安全威胁。所谓“同源”,是指协议、域名和端口三者必须完全一致。

同源策略目的

其核心目的是保障用户信息安全,防止恶意网站窃取其他域的数据。

同源策略限制的行为

  • Cookie、localStorage和IndexDB无法读取,即不同域间不能共享Cookie。
  • DOM结构和JavaScript对象无法获取,意味着不同域间不能相互操作DOM。
  • Ajax请求无法发送,即不同域间不能直接发起Ajax请求。

跨域解决方案概览

  • 通过JSONP实现跨域
  • 利用document.domain结合iframe进行跨域
  • 利用location.hash结合iframe进行跨域
  • 利用window.name结合iframe进行跨域
  • 利用postMessage进行跨域
  • 跨域资源共享(CORS)
  • 通过Nginx代理实现跨域
  • 通过Node.js中间件代理实现跨域
  • 利用WebSocket协议进行跨域

一、通过JSONP实现跨域

为了减轻Web服务器的负载,通常将JavaScript、CSS、图片等静态资源分离部署在另一台服务器上。HTML页面通过相应的标签从不同域名加载这些静态资源,这是浏览器允许的。基于此原理,我们可以通过动态创建script标签,并请求一个带参数的网址来实现跨域通信。

原生实现方式

<script>
    var script = document.createElement('script');
    script.type = 'text/javascript';

    // 传参并指定回调执行函数为onBack
    script.src = 'http://www.demo2.com:8080/login?user=admin&callback=onBack';
    document.head.appendChild(script);

    // 回调执行函数
    function onBack(res) {
        alert(JSON.stringify(res));
    }
 </script>

jQuery Ajax方式

$.ajax({
    url: 'http://www.demo2.com:8080/login',
    type: 'get',
    dataType: 'jsonp',  // 请求方式为jsonp
    jsonpCallback: "onBack",    // 自定义回调函数名
    data: {}
});

Vue.js框架支持

this.$http.jsonp('http://www.demo2.com:8080/login', {
    params: {},
    jsonp: 'onBack'
}).then((res) => {
    console.log(res); 
})

JSONP的局限性:仅支持实现GET类型的请求。

二、document.domain + iframe跨域

此方案仅适用于主域相同但子域不同的跨域应用场景。

实现原理:两个页面通过JavaScript强制将document.domain设置为基础主域,从而实现同域。

<iframe id="iframe" src="http://child.demo.com/b.html"></iframe>
<script>
    document.domain = 'demo.com';
    var user = 'admin';
</script>

1.)父窗口代码示例

<script>
    document.domain = 'demo.com';
    // 获取父窗口中变量
    alert('get js data from parent ---> ' + window.parent.user);
</script>

2.)子窗口代码示例

三、location.hash + iframe跨域

实现原理:若A域希望与B域进行跨域通信,可通过中间页C来实现。涉及三个页面,不同域之间利用iframe的location.hash进行传值,相同域之间则直接通过JavaScript访问进行通信。

具体实现流程:A域下的a.html -> B域下的b.html -> A域下的c.html。a与b不同域,只能通过hash值进行单向通信;b与c也不同域,同样只能单向通信;但c与a同域,因此c可通过parent.parent访问a页面的所有对象。

具体实现流程:A域下的a.html -> B域下的b.html -> A域下的c.html。a与b不同域,只能通过hash值进行单向通信;b与c也不同域,同样只能单向通信;但c与a同域,因此c可通过parent.parent访问a页面的所有对象。

具体实现代码:a.html

<iframe id="iframe" src="http://www.demo2.com/b.html" style="display:none;"></iframe>
<script>
    var iframe = document.getElementById('iframe');

    // 向b.html传hash值
    setTimeout(function() {
        iframe.src = iframe.src + '#user=admin';
    }, 1000);
    
    // 开放给同域c.html的回调方法
    function onCallback(res) {
        alert('data from c.html ---> ' + res);
    }
</script>

具体实现代码:b.html

<iframe id="iframe" src="http://www.demo1.com/c.html" style="display:none;"></iframe>
<script>
    var iframe = document.getElementById('iframe');

    // 监听a.html传来的hash值,再传给c.html
    window.onhashchange = function () {
        iframe.src = iframe.src + location.hash;
    };
</script>

具体实现代码:c.html

<script>
    // 监听b.html传来的hash值
    window.onhashchange = function () {
        // 再通过操作同域a.html的js回调,将结果传回
        window.parent.parent.onCallback('hello: ' + location.hash.replace('#user=', ''));
    };
</script>

四、window.name + iframe跨域

window.name属性的独特之处在于:name值在不同的页面(甚至不同域名)加载后依旧存在,并且可以支持非常长的name值(最大2MB)。

具体实现代码:a.html

var proxy = function(url, callback) {
    var state = 0;
    var iframe = document.createElement('iframe');

    // 加载跨域页面
    iframe.src = url;

    // onload事件会触发2次,第1次加载跨域页,并留存数据于window.name
    iframe.onload = function() {
        if (state === 1) {
            // 第2次onload(同域proxy页)成功后,读取同域window.name中数据
            callback(iframe.contentWindow.name);
            destoryFrame();

        } else if (state === 0) {
            // 第1次onload(跨域页)成功后,切换到同域代理页面
            iframe.contentWindow.location = 'http://www.demo1.com/proxy.html';
            state = 1;
        }
    };

    document.body.appendChild(iframe);

    // 获取数据以后销毁这个iframe,释放内存;这也保证了安全(不被其他域frame js访问)
    function destoryFrame() {
        iframe.contentWindow.document.write('');
        iframe.contentWindow.close();
        document.body.removeChild(iframe);
    }
};

// 请求跨域b页面数据
proxy('http://www.demo2.com/b.html', function(data){
    alert(data);
});

具体实现代码:proxy.html(中间代理页,与a.html同域,内容为空即可)。

具体实现代码:b.html

<script>
    window.name = 'This is demo2 data!';
</script>

总结:通过iframe的src属性由外域转向本地域,跨域数据即由iframe的window.name从外域传递到本地域。这种方式巧妙地绕过了浏览器的跨域访问限制,同时又是安全操作。

五、postMessage跨域

postMessage是HTML5 XMLHttpRequest Level 2中的API,也是为数不多可以跨域操作的window属性之一。它可用于解决以下方面的问题:a.)页面和其打开的新窗口之间的数据传递;b.)多窗口之间的消息传递;c.)页面与嵌套的iframe之间的消息传递;d.)上述三个场景的跨域数据传递。

用法:postMessage(data, origin)方法接受两个参数。data:HTML5规范支持任意基本类型或可复制的对象,但部分浏览器只支持字符串,因此传参时最好使用JSON.stringify()进行序列化。origin:协议+主机+端口号,也可以设置为"*",表示可以传递给任意窗口;如果要指定与当前窗口同源的话,设置为"/"。

具体实现代码:a.html

iframe id="iframe" src="http://www.demo2.com/b.html" style="display:none;"></iframe>
<script>       
    var iframe = document.getElementById('iframe');
    iframe.onload = function() {
        var data = {
            name: 'aym'
        };
        // 向domain2传送跨域数据
        iframe.contentWindow.postMessage(JSON.stringify(data), 'http://www.demo2.com');
    };

    // 接受domain2返回数据
    window.addEventListener('message', function(e) {
        alert('data from demo2 ---> ' + e.data);
    }, false);
</script>

具体实现代码:b.html

<script>
    // 接收domain1的数据
    window.addEventListener('message', function(e) {
        alert('data from demo1 ---> ' + e.data);

        var data = JSON.parse(e.data);
        if (data) {
            data.number = 16;

            // 处理后再发回domain1
            window.parent.postMessage(JSON.stringify(data), 'http://www.demo1.com');
        }
    }, false);
</script>

六、跨域资源共享(CORS)

普通跨域请求:只需服务端设置Access-Control-Allow-Origin即可,前端无需额外设置。若要携带Cookie请求,则前后端都需要进行相应设置。

需注意:由于同源策略的限制,所读取的Cookie为跨域请求接口所在域的Cookie,而非当前页。如果想实现当前页Cookie的写入,可参考下文:七、Nginx反向代理中设置proxy_cookie_domain和八、Node.js中间件代理中cookieDomainRewrite参数的设置。

目前,所有浏览器都支持该功能(IE8+:IE8/9需要使用XDomainRequest对象来支持CORS)。CORS已成为主流的跨域解决方案。

前端设置方法

1.)原生Ajax实现

// 前端设置是否带cookie
xhr.withCredentials = true;

示例代码展示

var xhr = new XMLHttpRequest(); // IE8/9需用window.XDomainRequest兼容

// 前端设置是否带cookie
xhr.withCredentials = true;

xhr.open('post', 'http://www.demo2.com:8080/login', true);
xhr.setRequestHeader('Content-Type', 'application/x-www-form-urlencoded');
xhr.send('user=admin');

xhr.onreadystatechange = function() {
    if (xhr.readyState == 4 && xhr.status == 200) {
        alert(xhr.responseText);
    }
};

2.)jQuery Ajax实现

$.ajax({
    ...
   xhrFields: {
       withCredentials: true    // 前端设置是否带cookie
   },
   crossDomain: true,   // 会让请求头中包含跨域的额外信息,但不会含cookie
    ...
});

3.)Vue框架支持

Vue.http.options.credentials = true

服务端设置方法

若后端设置成功,前端浏览器控制台则不会出现跨域报错信息;反之,说明设置未成功。

1.)PHP后台实现

response.setHeader("Access-Control-Allow-Origin", "http://www.domain1.com");  // 若有端口需写全(协议+域名+端口)
response.setHeader("Access-Control-Allow-Credentials", "true");

2.)Node.js后台示例

ar http = require('http');
var server = http.createServer();
var qs = require('querystring');

server.on('request', function(req, res) {
    var postData = '';

    // 数据块接收中
    req.addListener('data', function(chunk) {
        postData += chunk;
    });

    // 数据接收完毕
    req.addListener('end', function() {
        postData = qs.parse(postData);

        // 跨域后台设置
        res.writeHead(200, {
            'Access-Control-Allow-Credentials': 'true',     // 后端允许发送Cookie
            'Access-Control-Allow-Origin': 'http://www.demo1.com',    // 允许访问的域(协议+域名+端口)
            'Set-Cookie': 'l=a123456;Path=/;Domain=www.demo2.com;HttpOnly'   // HttpOnly:脚本无法读取cookie
        });

        res.write(JSON.stringify(postData));
        res.end();
    });
});

server.listen('8080');
console.log('Server is running at port 8080...');

七、Node.js中间件代理跨域

Node中间件实现跨域代理,原理大致与Nginx相同,都是通过启动一个代理服务器,实现数据的转发。也可以通过设置cookieDomainRewrite参数修改响应头中Cookie的域名,实现当前域的Cookie写入,方便接口登录认证。

1、非Vue框架的跨域(涉及2次跨域)

利用Node.js + Express + http-proxy-middleware搭建一个Proxy服务器。

1.)前端代码示例

var xhr = new XMLHttpRequest();

// 前端开关:浏览器是否读写cookie
xhr.withCredentials = true;

// 访问http-proxy-middleware代理服务器
xhr.open('get', 'http://www.demo1.com:3000/login?user=admin', true);
xhr.send();

2.)中间件服务器配置

var express = require('express');
var proxy = require('http-proxy-middleware');
var app = express();

app.use('/', proxy({
    // 代理跨域目标接口
    target: 'http://www.demo2.com:8080',
    changeOrigin: true,

    // 修改响应头信息,实现跨域并允许带cookie
    onProxyRes: function(proxyRes, req, res) {
        res.header('Access-Control-Allow-Origin', 'http://www.domain1.com');
        res.header('Access-Control-Allow-Credentials', 'true');
    },

    // 修改响应信息中的cookie域名
    cookieDomainRewrite: 'www.demo1.com'  // 可以为false,表示不修改
}));

app.listen(3000);
console.log('Proxy server is listen at port 3000...');

3.)Node.js后台代码

ar http = require('http');
var server = http.createServer();
var qs = require('querystring');

server.on('request', function(req, res) {
    var params = qs.parse(req.url.substring(2));

    // 向前台写cookie
    res.writeHead(200, {
        'Set-Cookie': 'l=a123456;Path=/;Domain=www.demo2.com;HttpOnly'   // HttpOnly:脚本无法读取
    });

    res.write(JSON.stringify(params));
    res.end();
});

server.listen('8080');
console.log('Server is running at port 8080...');

2、Vue框架的跨域(仅1次跨域)

利用Node.js + Webpack + webpack-dev-server代理接口跨域。在开发环境下,由于Vue渲染服务和接口代理服务都是webpack-dev-server同一个进程,所以页面与代理接口之间不再跨域,无须设置Headers跨域信息。

Webpack配置部分代码

module.exports = {
    entry: {},
    module: {},
    ...
    devServer: {
        historyApiFallback: true,
        proxy: [{
            context: '/login',
            target: 'http://www.demo2.com:8080',  // 代理跨域目标接口
            changeOrigin: true,
            secure: false,  // 当代理某些https服务报错时用
            cookieDomainRewrite: 'www.demo1.com'  // 可以为false,表示不修改
        }],
        noInfo: true
    }
}

八、WebSocket协议跨域

WebSocket协议是HTML5一种新的协议。它实现了浏览器与服务器全双工通信,同时允许跨域通讯,是Server Push技术的一种很好的实现。原生WebSocket API使用起来不太方便,我们使用Socket.io,它很好地封装了WebSocket接口,提供了更简单、灵活的接口,也对不支持WebSocket的浏览器提供了向下兼容。

1.)前端代码示例

<div>user input:<input type="text"></div>
<script src="./socket.io.js"></script>
<script>
var socket = io('http://www.demo2.com:8080');

// 连接成功处理
socket.on('connect', function() {
    // 监听服务端消息
    socket.on('message', function(msg) {
        console.log('data from server: ---> ' + msg); 
    });

    // 监听服务端关闭
    socket.on('disconnect', function() { 
        console.log('Server socket has closed.'); 
    });
});

document.getElementsByTagName('input')[0].onblur = function() {
    socket.send(this.value);
};
</script>

2.)Node.js Socket后台代码

// 启http服务
var server = http.createServer(function(req, res) {
    res.writeHead(200, {
        'Content-type': 'text/html'
    });
    res.end();
});

server.listen('8080');
console.log('Server is running at port 8080...');

// 监听socket连接
socket.listen(server).on('connection', function(client) {
    // 接收信息
    client.on('message', function(msg) {
        client.send('hello:' + msg);
        console.log('data from client: ---> ' + msg);
    });

    // 断开处理
    client.on('disconnect', function() {
        console.log('Client socket has closed.'); 
    });
});

九、Nginx代理跨域

1、Nginx配置解决Iconfont跨域

浏览器跨域访问JavaScript、CSS、图片等常规静态资源被同源策略许可,但Iconfont字体文件(eot|otf|ttf|woff|svg)例外,此时可在Nginx的静态资源服务器中加入以下配置。

location / {
  add_header Access-Control-Allow-Origin *;
}

2、Nginx反向代理接口跨域

跨域原理:同源策略是浏览器的安全策略,不是HTTP协议的一部分。服务器端调用HTTP接口只是使用HTTP协议,不会执行JavaScript脚本,不需要同源策略,也就不存在跨越问题。

实现思路:通过Nginx配置一个代理服务器(域名与demo1相同,端口不同)做跳板机,反向代理访问demo2接口,并且可以顺便修改Cookie中的Demo信息,方便当前域Cookie写入,实现跨域登录。

Nginx具体配置代码

#proxy服务器
server {
    listen       81;
    server_name  www.demo1.com;

    location / {
        proxy_pass   http://www.demo2.com:8080;  #反向代理
        proxy_cookie_demo www.demo2.com www.demo1.com; #修改cookie里域名
        index  index.html index.htm;

        # 当用webpack-dev-server等中间件代理接口访问nignx时,此时无浏览器参与,故没有同源限制,下面的跨域配置可不启用
        add_header Access-Control-Allow-Origin http://www.demo1.com;  #当前端只跨域不带cookie时,可为*
        add_header Access-Control-Allow-Credentials true;
    }
}

1.)前端代码示例

var xhr = new XMLHttpRequest();

// 前端开关:浏览器是否读写cookie
xhr.withCredentials = true;

// 访问nginx中的代理服务器
xhr.open('get', 'http://www.demo1.com:81/?user=admin', true);
xhr.send();

2.)Node.js后台示例

var http = require('http');
var server = http.createServer();
var qs = require('querystring');

server.on('request', function(req, res) {
    var params = qs.parse(req.url.substring(2));

    // 向前台写cookie
    res.writeHead(200, {
        'Set-Cookie': 'l=a123456;Path=/;Domain=www.demo2.com;HttpOnly'   // HttpOnly:脚本无法读取
    });

    res.write(JSON.stringify(params));
    res.end();
});

server.listen('8080');
console.log('Server is running at port 8080...');

到此这篇关于前端处理跨域的九种方式的文章就介绍到这了,更多相关前端跨域内容请搜索本站以前的文章或继续浏览下面的相关文章,希望大家以后多多支持本站!

实用工具推荐

电子包浆

绿化、压缩、噪点和虚拟水印,自由调节做旧程度。

使用 ›
图片压缩

选择画质和输出格式,预览压缩前后的大小。

使用 ›
相关文章