文章

Nginx 配置跨域请求 Access-Control-Allow-Origin *

关于 nginx 跨域请求资源的一些配置说明。

原文: https://segmentfault.com/a/1190000012550346

作者: Developer

本作品系 原作者原创 , 采用《署名-非商业性使用-禁止演绎 4.0 国际》许可协议

当出现 403 跨域错误的时候 No 'Access-Control-Allow-Origin' header is present on the requested resource,需要给 Nginx 服务器配置响应的 header参数:

一、 解决方案

只需要在Nginx的配置文件中配置以下参数:

1
2
3
4
5
6
7
8
9
10
#!conf
location / {  
    add_header Access-Control-Allow-Origin *;
    add_header Access-Control-Allow-Methods 'GET, POST, OPTIONS';
    add_header Access-Control-Allow-Headers 'DNT,X-Mx-ReqToken,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Authorization';

    if ($request_method = 'OPTIONS') {
        return 204;
    }
} 

上面配置代码即可解决问题了,不想深入研究的,看到这里就可以啦=-=

二、 解释

1. Access-Control-Allow-Origin

服务器默认是不被允许跨域的。给 Nginx 服务器配置Access-Control-Allow-Origin *后,表示服务器可以接受所有的请求源(Origin),即接受所有跨域的请求。

2. Access-Control-Allow-Headers 是为了防止出现以下错误:

1
2
#!shell
Request header field Content-Type is not allowed by Access-Control-Allow-Headers in preflight response.

这个错误表示当前请求 Content-Type 的值不被支持。其实是我们发起了 application/json 的类型请求导致的。这里涉及到一个概念:预检请求(preflight request),请看下面”预检请求”的介绍。

3. Access-Control-Allow-Methods 是为了防止出现以下错误:

1
2
#!shell
Content-Type is not allowed by Access-Control-Allow-Headers in preflight response.

4.给 OPTIONS 添加 204 的返回,是为了处理在发送 POST 请求时 Nginx 依然拒绝访问的错误

发送”预检请求”时,需要用到方法 OPTIONS ,所以服务器需要允许该方法。

三、 预检请求(preflight request)

其实上面的配置涉及到了一个 W3C 标准: CROS,全称是跨域资源共享 (Cross-origin resource sharing),它的提出就是为了解决跨域请求的。

跨域资源共享(CORS)标准新增了一组 HTTP 首部字段,允许服务器声明哪些源站有权限访问哪些资源。另外,规范要求,对那些可能对服务器数据产生副作用的HTTP 请求方法(特别是 GET 以外的 HTTP 请求,或者搭配某些 MIME 类型的 POST 请求),浏览器必须首先使用 OPTIONS 方法发起一个预检请求(preflight request),从而获知服务端是否允许该跨域请求。服务器确认允许之后,才发起实际的 HTTP 请求。在预检请求的返回中,服务器端也可以通知客户端,是否需要携带身份凭证(包括 Cookies 和 HTTP 认证相关数据)。

其实 Content-Type 字段的类型为 application/json 的请求就是上面所说的搭配某些 MIME 类型的 POST 请求,CORS 规定,Content-Type 不属于以下 MIME 类型的,都属于预检请求:

1
2
3
4
#!shell
application/x-www-form-urlencoded
multipart/form-data
text/plain

所以 application/json 的请求 会在正式通信之前,增加一次”预检”请求,这次”预检”请求会带上头部信息 Access-Control-Request-Headers: Content-Type

1
2
3
4
5
6
#!shell
OPTIONS /api/test HTTP/1.1
Origin: http://foo.example
Access-Control-Request-Method: POST
Access-Control-Request-Headers: Content-Type
... 省略了一些

服务器回应时,返回的头部信息如果不包含 Access-Control-Allow-Headers: Content-Type 则表示不接受非默认的的 Content-Type。即出现以下错误:

1
2
#!shell
Request header field Content-Type is not allowed by Access-Control-Allow-Headers in preflight response.

参考文章:

本文由作者按照 CC BY 4.0 进行授权