详解SpringBoot应用跨域访问解决方案

1、什么是跨域访问

说到跨域访问，必须先解释一个名词：同源策略。所谓同源策略就是在浏览器端出于安全考量，向服务端发起请求必须知足：协议相同、Host(ip)相同、端口相同的条件，不然访问将被禁止，该访问也就被称为跨域访问。 虽然跨域访问被禁止以后，能够在必定程度上提升了应用的安全性，但也为开发带来了必定的麻烦。好比：咱们开发一个先后端分离的易用，页面及js部署在一个主机的nginx服务中，后端接口部署在一个tomcat应用容器中，当前端向后端发起请求的时候必定是不符合同源策略的，也就没法访问。那么咱们如何解决这个问题？就是本文须要向你们说明的内容。

2、跨域访问的解决方案有哪些？

2.1.第一类方案：前端解决方案

虽然浏览器对于不符合同源策略的访问是禁止的，可是仍然存在例外的状况，如如下资源引用的标签不受同源策略的限制：

• html的script标签
• html的link标签
• html的img标签
• html的iframe标签：对于使用jsp、freemarker开发的项目，这是实现跨域访问最多见的方法，

除了基于HTML自己的特性实现跨域访问，咱们还可使用jsonp、window的postMessage实现跨域访问。这些都是前端实现跨域访问的方式。

2.2.第二类方案：使用代理

实际上对跨域访问的支持在服务端实现起来更加容易，最经常使用的方法就是经过代理的方式，如：

• nginx或haproxy代理跨域
• nodejs中间件代理跨域

其实实现代理跨域的逻辑很是简单：就是在不一样的资源服务：js资源、html资源、css资源、接口数据资源服务的前端搭建一个中间层，全部的浏览器及客户端访问都经过代理转发。因此在浏览器、客户端看来，它们访问的都是同一个ip、同一个端口的资源，从而符合同源策略实现跨域访问。

2.3 第三类方案：CORS

跨域资源共享（CORS）：经过修改Http协议header的方式，实现跨域。说的简单点就是，经过设置HTTP的响应头信息，告知浏览器哪些状况在不符合同源策略的条件下也能够跨域访问，浏览器经过解析Http协议中的Header执行具体判断。具体的Header以下：

CROS跨域经常使用header

• Access-Control-Allow-Origin: 容许哪些ip或域名能够跨域访问
• Access-Control-Max-Age: 表示在多少秒以内不须要重复校验该请求的跨域访问权限
• Access-Control-Allow-Methods: 表示容许跨域请求的HTTP方法，如：GET,POST,PUT,DELETE
• Access-Control-Allow-Headers: 表示访问请求中容许携带哪些Header信息，如：Accept、Accept-Language、Content-Language、Content-Type

3、SpringBoot下实现CORS的四种方式

为你们介绍四种实现CORS的方法，两种是全局配置，两种是局部接口生效的配置。通常来讲，SpringBoot项目采用其中一种方式实现CORS便可。

3.1.使用CorsFilter进行全局跨域配置

@Configuration
    public class GlobalCorsConfig {
        @Bean
        public CorsFilter corsFilter() {
    
            CorsConfiguration config = new CorsConfiguration();
            //开放哪些ip、端口、域名的访问权限，星号表示开放全部域
            config.addAllowedOrigin("*");
            //是否容许发送Cookie信息
            config.setAllowCredentials(true);
            //开放哪些Http方法，容许跨域访问
            config.addAllowedMethod("GET","POST", "PUT", "DELETE");
            //容许HTTP请求中的携带哪些Header信息
            config.addAllowedHeader("*");
            //暴露哪些头部信息（由于跨域访问默认不能获取所有头部信息）
            config.addExposedHeader("*");
    
            //添加映射路径，“/**”表示对全部的路径实行全局跨域访问权限的设置
            UrlBasedCorsConfigurationSource configSource = new UrlBasedCorsConfigurationSource();
            configSource.registerCorsConfiguration("/**", config);
    
            return new CorsFilter(configSource);
        }
    }

3.2. 重写WebMvcConfigurer的addCorsMappings方法（全局跨域配置）

@Configuration
    public class GlobalCorsConfig {
        @Bean
        public WebMvcConfigurer corsConfigurer() {
            return new WebMvcConfigurer() {
                @Override
                public void addCorsMappings(CorsRegistry registry) {
                    registry.addMapping("/**")    //添加映射路径，“/**”表示对全部的路径实行全局跨域访问权限的设置
                            .allowedOrigins("*")    //开放哪些ip、端口、域名的访问权限
                            .allowCredentials(true)  //是否容许发送Cookie信息 
                            .allowedMethods("GET","POST", "PUT", "DELETE")     //开放哪些Http方法，容许跨域访问
                            .allowedHeaders("*")     //容许HTTP请求中的携带哪些Header信息
                            .exposedHeaders("*");   //暴露哪些头部信息（由于跨域访问默认不能获取所有头部信息）
                }
            };
        }
    }

3.3.使用CrossOrigin注解（局部跨域配置）

• 将CrossOrigin注解加在Controller层的方法上，该方法定义的RequestMapping端点将支持跨域访问
• 将CrossOrigin注解加在Controller层的类定义处，整个类全部的方法对应的RequestMapping端点都将支持跨域访问

@RequestMapping("/cors")
    @ResponseBody
    @CrossOrigin(origins = "http://localhost:8080", maxAge = 3600) 
    public String cors( ){
        return "cors";
    }

3.4 使用HttpServletResponse设置响应头(局部跨域配置)

这种方式略显麻烦，不建议在SpringBoot项目中使用。

@RequestMapping("/cors")
    @ResponseBody
    public String cors(HttpServletResponse response){
        //使用HttpServletResponse定义HTTP请求头，最原始的方法也是最通用的方法
        response.addHeader("Access-Control-Allow-Origin", "http://localhost:8080");
        return "cors";
    }

4、实现与测试

在SpringBoot项目外随便定义一个HTML，并写代码触发以下的ajax代码。（触发过程我就不写了，定义一个按钮加一个监听函数便可）。如下是跨域AJAX请求验证的核心代码：

$.ajax({
            url: 'http://localhost:8090/cors',
            type: "POST",
            xhrFields: {
               withCredentials: true    //容许发送Cookie信息
            },
            success: function (data) {
                alert("跨域请求配置成功")
            },
            error: function (data) {
                alert("跨域请求配置失败")
            }
        })

• 跨域请求配置成功表示：咱们的跨域配置生效，ajax请求能够正确访问服务端接口。
• 跨域请求配置失败表示：咱们的跨域配置未生效，请参照检查第三节检查各项配置是否正确。

期待您的关注

• 博主最近新写了一本书：《手摸手教您学习SpringBoot系列-16章97节》
• 本文转载注明出处（必须带链接，不能只转文字）：字母哥博客。