RESTful API 实现中的跨域资源共享技巧

随着 web 应用的日益普及,前端开发中的 ajax 调用后端接口也越来越常见。在这个过程中,很容易遇到跨域问题,即 ajax 请求的目标服务端与当前页的域名不一致。本文将探讨 RESTful API 实现中的跨域资源共享技巧,介绍常见的跨域问题及解决方案。

什么是跨域请求

跨域请求,又称 CORS (Cross-Origin Resource Sharing),是指在浏览器之间进行 HTTP 请求时,由于当前页面的域名和请求的目标地址不同,导致浏览器在安全策略上做出的限制,请求被禁止。通俗地说,就是你用 ajax 请求一个不是你当前域名下的接口,请求会被禁止。

跨域资源共享的实现

CORS 是 W3C 标准,所有浏览器都支持。CORS 操作是浏览器自动完成的,不需要用户参与。相比 JSONP,CORS 的优势在于:

  • JSONP 只支持 GET 请求,而 CORS 支持所有类型的 HTTP 请求。
  • 使用 CORS,开发者可以使用普通的 XMLHttpRequest,将请求发送到任何想要使用的网站上。jsonp 的实现主要是在前端使用Script标签动态引入,不支持http header。
  • CORS 支持所有类型的 HTTP 认证,而 JSONP 只支持 GET 请求无法访问请求的响应头等其他信息。

大致原理:

  1. 客户端发起跨域请求。
  2. 服务端在响应头中添加 Access-Control-Allow-* 字段,表示允许客户端请求服务器。
  3. 客户端检查响应头中的 Access-Control-Allow-* 字段,确定是否可以继续执行请求。

前端实现

在 ajax 调用接口时,可以通过 XMLHttpRequest 对象的 setRequestHeader 方法设置请求头,包括 Origin、Credentials、Content-Type 等字段。服务器收到请求后,解析请求头,根据需要添加响应头。

----- --- - --- -----------------
---------------- ----------------------------- ------
------------------------------------ --------------------
---------------------------------------- ------------------
------------------- - -----  -- -----------------------------

---------------------- - -------- -- -
  -- --------------- --- ------------------- -- ---------- --- ---- -
    --------------------------
  -
--

-------------------------
  ----- -----
  ---- --
----

后端实现

在服务端返回响应时,在响应头部分添加 Access-Control-Allow-* 字段。

-- -- ---- --
----- --- - ---------------
----- --- - --- ------

------------- ----- ----- -- -
    ----------------------------------------------- ----- -- -----------
    ------------------------------------------------ -------------- --------------- -------------- ------- ------------------- -- -------------
    ------------------------------------------------ ----- ----- ---- ------- ---------- -- ------------

    -- ------------------- --- ---------- - -- ------
        ---------- - ----
        -------
    -

    ----- -------
---

------------- ----- ----- -- -
    -- --------- --- -------- -
        ----- -------
        -------
    -

    -- -------- ---- ---
    ----- ---- - ----- --- ----------------- ------- -- -
        ----- ------ - ---
        ------------------ ----- -- --------------------
        ----------------- -- -- -
            ----- ------ - ----------------------
            ----- ---- - ------------------
            --------------------------
        ---
    ---

    -- ------
    ----- - ----- --- - - -----
    ----- ------- - - --- -- ----- --- --
    -- ---------------
    -------- - --------
---

---------------- -- -- -
    ------------------- ------- -- ------------------------
---

常见问题及解决方案

1. 请求头携带Cookie无法发送

发送 ajax 请求时,浏览器默认不会携带 Cookie 信息,需要服务器设置响应头中的 Access-Control-Allow-Credentials 字段为 true。

前端代码:

------------------- - ----- -- -----------------------------

后端代码:

---------------------------------------------------- ------ -- ------ ------

2. 自定义请求头字段

默认情况下,浏览器只允许浏览器自定义请求头字段 X-Requested-With 和 Accept,则可以让服务端响应“Access-Control-Allow-Headers”头,该头部字段是对浏览器的指定。

前端代码:

---------------------------------------- ------------------

后端代码:

------------------------------------------------ -------------- --------------- -------------- ------- -------------------

3. 跨域请求的 PUT、DELETE 方法

浏览器默认不支持跨域请求的 PUT、DELETE 方法,需要服务器设置响应头中的 Access-Control-Allow-Methods 字段为 PUT、DELETE。

前端代码:

--------------- ------------------------------- ------
------------------------- ----- ---- ----

后端代码:

------------------------------------------------ ----- ----- ---- ------- ----------

4. 预检请求 OPTIONS 的处理

对于跨域请求,浏览器在发送正式请求之前会先发送 OPTIONS 请求,用于获知服务端对于请求的支持情况、请求中是否合法以及是否有访问权限。常见返回码如下:

  • 200:表明该路由或方法在本次请求期间是合法的,浏览器可以继续发送真正的请求;
  • 403:表示该路由或方法在本次请求期间是非法的,浏览器不再继续发送真正的请求;
  • 404:表示该路由或资源不存在(但该方法依然合法),浏览器不再继续发送真正的请求;
  • 405:表示该路由虽然有效,但该方法是被禁止的,浏览器不应再次发送带有相同路径和方法的请求。
  • 206:表示请求内容范围未得到满足,请求头 Range 指定的范围超出实际范围。将Range Range: bytes=0-5

前端代码:

---------------- ----------------------------- ------
------------------------------------ --------------------
---------------------------------------- ------------------
------------------- - -----

-- --------------- --- ------------------- -- ---------- --- ---- -
  --------------------------
- ---- -- --------------- --- ------------------- -- ---------- --- -- -
  ------------------ -------
  -------------------------
    ----- -----
    ---- --
  ----
- ---- -- --------------- --- ------------------- -- ---------- --- ---- -
  ------------------------
- ---- -
  ------------------------
-

后端代码:

------------- ----- ----- -- -
  -- ------------------- --- ---------- - -- ------
    -------- - ---
    ----------------------------------------------- -----
    ------------------------------------------------ -------------- --------------- -------------- ------- -------------------
    ------------------------------------------------ ----- ----- ---- ------- ----------
    ------------------------------------------ --------- -- ------ -- -
    ------------------- - ----
    -------
  -

  ----- -------
---

总结

总的来说,CORS 协议是一种用来解决跨域问题的标准,它通过在服务端添加一些响应头,来告知浏览器跨域请求是否允许。IE 10 以下比较麻烦,不过通常前后端工程师会考虑到这点,解决方法大致分以下几点:

  • 需要客户端发送请求时,设置 withCredentials 字段;
  • 设置响应头 Access-Control-Allow-Origin 为 *,或是请求来自的地址;
  • 如果用户自定义 header ,需要服务端请求头部中添加相应的响应头 Access-Control-Allow-Headers;
  • 如果服务端允许跨域请求的 PUT、DELETE 方法,需要添加 Access-Control-Allow-Methods 响应头;
  • 添加 OPTIONS 预检请求,对后端响应头进行增加,保证与真实请求相同条件。
  • 处理 OPTIONS 预检请求,推荐使用 nookies 这个轮子。

来源:JavaScript中文网 ,转载请联系管理员! 本文地址:https://www.javascriptcn.com/post/647d5340968c7c53b0823e4e


猜你喜欢

  • ECMAScript 2019 和 2020 中值得学习的 12 个特性

    ECMAScript(也称为 JavaScript)是前端开发人员必须掌握的一项关键技能。在过去的几年中,ECMAScript已经迅速发展,越来越多的新特性进入了语言规范中。

    1 年前
  • Enzyme 测试 React 组件中模拟 API 请求的实现方式

    在开发 React 前端应用时,我们通常需要与后端接口进行交互来获取数据或执行操作。这时候我们需要对接口进行测试,以确保我们的组件在不同情况下都能正常工作。一种测试方法是使用 Enzyme 库来模拟 ...

    1 年前
  • 如何解决 window.URL.createObjectURL 报错的问题

    在前端开发中,我们经常会用到 window.URL.createObjectURL 方法来生成一个 URL 对象,以便将一个 Blob 或 File 对象转换成一个可预览的链接。

    1 年前
  • 如何在 Cypress 中实现接口测试

    在前端开发过程中,接口测试是非常重要的一部分,可以确保接口的正确性和可靠性。Cypress 是一个非常流行的前端测试框架,支持对接口进行测试。本文将介绍如何在 Cypress 中实现接口测试。

    1 年前
  • RxJS 的 retryWhen 操作符用法详解

    前言 RxJS 是一个强大的响应式编程库,它提供了丰富的操作符来处理各种数据流操作。其中的 retryWhen 操作符能够让我们轻松地处理异步请求的错误和重试操作,本文将从实践和应用的角度,详细讲解如...

    1 年前
  • Koa2 中异步文件读取的解决方法总结

    在进行前端开发过程中,经常需要读取文件。而在使用 Koa2 进行开发时,由于其采用了异步的方式进行文件读取,会带来一些困惑和难点。本文就介绍一些 Koa2 中异步文件读取的解决方法。

    1 年前
  • SSE客户端连接失败的判断及相应的处理方式

    SSE (Server-Sent Events) 是一种用于服务器向客户端推送数据的技术。在前端开发中,SSE 被广泛应用于实现实时通信、消息推送、聊天室等 Web 应用中。

    1 年前
  • Sass 中的单位,如何正确使用

    在 Sass 中,单位不仅是表示数值大小的一种方式,还可以影响到编译后的 CSS 代码的输出。如果你不了解 Sass 中单位的使用方法,可能会导致你的样式表出现问题。

    1 年前
  • Angular 中实现服务热替换的步骤

    前端开发中,服务热替换(Hot Module Replacement,HMR)是提高开发效率和体验的重要工具。而在使用 Angular 进行开发时,服务热替换的实现也变得尤为重要。

    1 年前
  • PM2 与 Nginx 配合实现 Node.js 进程的动态负载均衡

    在高并发的应用场景中,单个 Node.js 进程可能无法承受大量的并发请求。为了解决这个问题,我们可以使用进程管理器 PM2 来开启多个 Node.js 进程,并用 Nginx 来实现动态负载均衡,从...

    1 年前
  • Mongoose 中的 Count 查询和范围查询详解

    Mongoose 是一个 Node.js 中常用的 MongoDB 驱动工具,它能够让开发者在 Node.js 应用中定义和访问 MongoDB 数据库的数据模型。

    1 年前
  • RESTful API 设计中常见的错误及解决方案

    REST(Representational State Transfer)是一种常用于Web应用程序设计的软件架构风格,它通过统一接口对网络资源进行操作。而RESTful API也是Web开发中重要的...

    1 年前
  • Socket.io 与多线程的实现方式讲解

    背景 在前端开发中,随着用户量和业务量的不断增长,各种性能瓶颈也在不断出现。其中,前端与服务端的网络通信是一个很重要的方面。但是在传统的 HTTP 请求方式下,与服务端的通信可能会遇到一些问题,例如:...

    1 年前
  • 如何使用 Material Design 实现自定义内容切换动画

    在前端开发中,如何实现吸引人的切换动画一直是一个不可忽视的问题。而 Material Design 的各种交互设计与动画效果给了我们很好的参考,下面就来介绍一下如何利用 Material Design...

    1 年前
  • 如何在 Mocha 测试中测试 Web 应用程序

    如何在Mocha测试中测试Web应用程序 Mocha是Node.js中最流行的测试框架之一,它提供了一种简单而可扩展的方式来编写和运行测试用例。在本文中,我们将探讨如何使用Mocha测试Web应用程序...

    1 年前
  • Vue.js 如何正确使用 Vuex 关联普通数组

    前言 Vue.js 是一个令人印象深刻的前端框架,它在构建复杂应用程序时能够提供更好的组织性和可维护性。Vuex 则是一个专门为 Vue.js 设计的状态管理库,它可以让我们以一种可预测的方式管理应用...

    1 年前
  • 如何在 Express.js 中使用 bcrypt.js 实现密码哈希

    随着互联网的不断发展和进步,网站和应用程序的用户量越来越大,因此安全问题也日益凸显。在用户注册时,为了保护用户密码,常需要对用户密码进行哈希处理,这样即使数据库被攻击,也保证用户密码不被泄露。

    1 年前
  • Next.js 中使用 webpack-bundle-analyzer 分析打包后的构建结果

    在 Next.js 项目中,Webpack 负责把多个 JavaScript 和 CSS 文件打包成一个或多个文件,以提高页面加载速度。然而,这个打包过程须经过一定优化以避免打包后文件过大、加载时间过...

    1 年前
  • 详解使用 Custom Elements 进行前端开发

    Custom Elements 是一项可以自定义 HTML 标签的 Web API,可以让开发者创建自己的 HTML 元素和组件,而不用考虑与其他标签和组件之间的冲突和命名空间问题。

    1 年前
  • Redux 更好的数据管理方案

    在前端开发中,数据管理是一个至关重要的问题,随着前端架构的不断发展和复杂性的增加,传统的数据管理方式已经不能满足需求。因此,Redux 的出现提供了一种更好的解决方案。

    1 年前

相关推荐

    暂无文章