springboot怎么加cors标头 springboot配置cors

文章目录

• 1.同源策略

• 1.1 什么是源
• 1.2 什么是同源
• 1.3 是否为同源的判断
• 1.4 哪些操作不受同源策略限制

• 2. 跨域

• 2.1 如何跨域

• 3. CORS

• 3.1 什么是CORS
• 3.2 简单请求
• 3.3 非简单请求

• 4. SpringBoot 配置CORS

• 4.1 给某一个接口配置CORS
• 4.2 给某一系列接口配置CORS
• 4.3 全局配置CORS
• 4.4 原理剖析

  现在前后端分离已成开发趋势，我们前端用的ionic，后端用的springBoot，既然前后端分离开发就一定会遇到跨域问题，可以通过服务器的反向代理来解决，但我这站在服务端的角度，用cors解决跨域问题。

1.同源策略

  同源策略[same origin policy]是浏览器的一个安全功能，不同源的客户端脚本在没有明确授权的情况下，不能读写对方资源。 同源策略是浏览器安全的基石

1.1 什么是源

  源[origin]就是协议、域名和端口号。例如：http://www.baidu.com:80这个URL即为一个源

1.2 什么是同源

  若地址里面的协议、域名和端口号均相同则属于同源

1.3 是否为同源的判断

  例如判断下面的URL是否与 http://www.a.com/test/index.html 同源

http://www.a.com/dir/page.html 同源http://www.child.a.com/test/index.html 不同源，域名不相同https://www.a.com/test/index.html 不同源，协议不相同http://www.a.com:8080/test/index.html 不同源，端口号不相同

1.4 哪些操作不受同源策略限制

• 页面中的链接，重定向以及表单提交是不会受到同源策略限制的；
• 跨域资源的引入是可以的。但是JS不能读写加载的内容。如嵌入到页面中的<script src="..."></script>，<img>，<link>，<iframe>等。

2. 跨域

  受前面所讲的浏览器同源策略的影响，不是同源的脚本不能操作其他源下面的对象。想要操作另一个源下的对象就需要跨域。 在同源策略的限制下，非同源的网站之间不能发送 AJAX 请求

2.1 如何跨域

• 降域:可以通过设置 document.damain=‘a.com’，浏览器就会认为它们都是同一个源。想要实现以上任意两个页面之间的通信，两个页面必须都设置documen.damain=‘a.com’。
• JSONP跨域
• CORS 跨域

3. CORS

3.1 什么是CORS

  CORS是一个W3C标准，全称是"跨域资源共享"（Cross-origin resource sharing）。它允许浏览器向跨源服务器，发出XMLHttpRequest请求，从而克服了AJAX只能同源使用的限制。CORS 做到了如下两点：

• 不破坏即有规则
• 服务器实现了 CORS 接口，就可以跨源通信

基于这两点，CORS 将请求分为两类：简单请求和非简单请求。

3.2 简单请求

  请求方式为head,get和post，发送HTTP请求时在头信息中不能包含任何自定义字段，且 HTTP 头信息不超过以下几个字段，即为简单请求：

Accept Accept-Language
Content-Language
Last-Event-ID
Content-Type 只限于 [application/x-www-form-urlencoded 、multipart/form-data、text/plain ] 类型

一个简单的请求例子：

GET /test
HTTP/1.1 Accept: /
Accept-Encoding: gzip, deflate, sdch, br
Origin: http://www.examples.com Host: www.examples.com

  对于简单请求，CORS的策略是请求时在请求头中增加一个Origin字段，服务器收到请求后，根据该字段判断是否允许该请求访问。

• 如果允许，则在 HTTP 头信息中添加 Access-Control-Allow-Origin 字段，并返回正确的结果 ；
• 如果不 允许，则不在 HTTP 头信息中添加 Access-Control-Allow-Origin 字段

除了上面提到的 Access-Control-Allow-Origin ，还有几个字段用于描述 CORS 返回结果

• Access-Control-Allow-Credentials： 可选，用户是否可以发送、处理 cookie；
• Access-Control-Expose-Headers：可选，可以让用户拿到的字段。有几个字段无论设置与否都可以拿到的，包括：Cache-Control、Content-Language、Content-Type、Expires、Last-Modified、Pragma
  。

3.3 非简单请求

浏览器会在真实请求发出前，增加一次OPTION请求，称为预检请求(preflight request)。预检请求将真实请求的信息，包括请求方法、自定义头字段、源信息添加到 HTTP 头信息字段中，询问服务器是否允许这样的操作（即浏览器先询问服务器，当前网页所在的域名是否在服务器的许可名单之中，以及可以使用哪些HTTP动词和头信息字段。只有得到肯定答复，浏览器才会发出正式的XMLHttpRequest请求，否则就报错）。

一个DELETE请求：

OPTIONS /test HTTP/1.1 Origin: http://www.examples.com Access-Control-Request-Method: DELETE Access-Control-Request-Headers: X-Custom-Header Host: www.examples.com

与 CORS 相关的字段有：

请求使用的 HTTP 方法 Access-Control-Request-Method ；
请求中包含的自定义头字段: Access-Control-Request-Headers 。

  服务器收到请求时，需要分别对 Origin、Access-Control-Request-Method、Access-Control-Request-Headers 进行验证，验证通过后，会在返回 HTTP头信息中添加 ：

Access-Control-Allow-Origin: http://localhost:4200  //1.请求的源 Access-Control-Allow-Methods: GET, POST, PUT, DELETE  //2.真实请求允许的方法
Access-Control-Allow-Headers: X-Custom-Header  //3.服务器允许使用的字段
Access-Control-Allow-Credentials: true  //4.是否允许用户发送，处理 cookie
Access-Control-Max-Age: 1728000  //5.预检请求的有效期，单位为秒。有效期内，不会重复发送预检请求,当预检请求通过后，浏览器会发送真实请求到服务器。这就实现了跨源请求

4. SpringBoot 配置CORS

4.1 给某一个接口配置CORS

  如果想要对某一接口配置 CORS，可以在方法上添加 @CrossOrigin 注解 ：

@CrossOrigin(origins = {"http://localhost:4200", "null"})
@RequestMapping(value = "/test", method = RequestMethod.GET)
public String test() {
    return "测试CORS解决跨域";
}

4.2 给某一系列接口配置CORS

  如果想对一系列接口添加 CORS 配置，可以在类上添加注解，对该类声明所有接口都有效：

@CrossOrigin(origins = {"http://localhost:4200", "null"})
@RestController
@SpringBootApplication
public class SpringBootCorsTestApplication {
    
}

4.3 全局配置CORS

  如果想给所有的接口配置CORS，即添加全局配置，则需要添加一个配置类：

@Configuration
public class CorsConfig {
    private CorsConfiguration buildConfig() {
        CorsConfiguration corsConfiguration = new CorsConfiguration();
        corsConfiguration.addAllowedOrigin("*");   //可以通过的ip，*代表所有，可以使用指定的ip，多个的话可以用逗号分隔，默认为*
        corsConfiguration.addAllowedHeader("*");  //请求支持的头信息，默认为*，所有 
        corsConfiguration.addAllowedMethod("*");  //请求方式 默认为*,所有
        corsConfiguration.setAllowCredentials(true);  //支持证书，默认为true
        return corsConfiguration;
    }

   // 通过添加 Filter 的方式，配置 CORS 规则，并手动指定对哪些接口有效
    @Bean
    public CorsFilter corsFilter() {
        UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
        source.registerCorsConfiguration("/**", buildConfig());  // CORS 配置对所有接口都有效
        return new CorsFilter(source);
    }

}

4.4 原理剖析

  无论是通过哪种方式配置 CORS，其实都是在构造 CorsConfiguration。 一个 CORS 配置用一个 CorsConfiguration类来表示。校验就是根据 CorsConfiguration 这个类的配置进行判断：

1. 判断 origin 是否合法
2. 判断 method 是否合法
3. 判断 header是否合法
4. 如果全部合法，则在 response header中添加响应的字段，并交给负责该请求的类处理，如果不合法，则拒绝该请求

  CORS Filter实现标准的Javax.servlet.Filter接口，拦截进入的HTTP请求，如果识别出该请求为跨域的，则向请求中加入适用的CORS策略和header信息，然后再将该HTTP请求传递给真正的请求目标（包括servlets、JSPs、静态XML/HTML文档等。