做优秀网站一站式媒体发布平台

1. 前置知识

1. 【尚硅谷】【视频】【B站】禹神：一小时彻底搞懂跨域&解决方案
2. 【尚硅谷】【笔记】【CSDN】禹神：彻底搞懂前端跨域&解决方案

2. 原理和解决方案总结

2.1. 跨域不通过原理流程图

2.2. 实现原理：添加以下http响应头

序号	响应头	含义
1	Access-Control-Allow-Origin	允许的源
2	Access-Control-Allow-Methods	允许的方法
3	Access-Control-Allow-Headers	允许的自定义头
4	Access-Control-Max-Age	预检请求的结果缓存时间（可选）

2.3. 四种跨域实现方式及优先级（从高到低）

1. 跨域全局配置方式-Filter(全适用)： 重写 Filter.doFilter()，设置 res.setHeader(“Access-Control-Allow-Origin”, “*”) 等响应头参数
2. 跨域全局配置方式-SpringMvc ： 重写 WebMvcConfigurer.addCorsMappings()，设置 registry.addMapping(“/**”).allowedOrigins(“*”)等响应头参数（只对SpringMvc写法生效，对原生Servlet不生效）
3. 跨域单个配置方式-WebServlet： 设置 res.addHeader(“Access-Control-Allow-Origin”, “*”) 等响应头参数
4. 跨域单个配置方式-SpringMvc ： 添加 @CrossOrigin注解，设置origins等响应头参数（只对SpringMvc写法生效，对原生Servlet不生效）

3. 具体实现代码

• gitee源码

3.1. 跨域全局配置方式-Filter(全适用)

• 重写Filter.doFilter()，设置 res.setHeader("Access-Control-Allow-Origin", "*") 等响应头参数

/** 1.跨域全局配置方式-Filter(全适用) */
@Configuration
public class CorsFilter implements Filter {@Overridepublic void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {HttpServletResponse res = (HttpServletResponse) response;res.setHeader("Access-Control-Allow-Origin", req.getHeader("Origin"));                                  //【跨域配置】[必需]               允许请求源  ：默认值 无，配置"*"允许所有。// 如果是复杂请求的预检请求（判断逻辑同SpringMvc），设置以下响应头，且没必要执行其它过滤器链 chain.doFilter(request, response);if (req.getMethod().equalsIgnoreCase("OPTIONS") && !ObjUtil.hasNull(req.getHeader("Origin"), req.getHeader("Access-Control-Request-Method"))) {res.setHeader("Access-Control-Allow-Methods", req.getHeader("Access-Control-Request-Method"));      //【跨域配置】[有复杂请求方法时必需]  允许请求方法：默认值 无，配置 "*"，允许所有res.setHeader("Access-Control-Allow-Headers", req.getHeader("Access-Control-Request-Headers"));     //【跨域配置】[有复杂请求头时必需]    允许请求头 ： 默认值 无，配置 "*"，允许所有res.setHeader("Access-Control-Max-Age", "5");                                                       //【跨域配置】[非必需]             预检缓存时长： 默认值 依赖客户端。EDGE浏览器默认值为3秒。【注意浏览器不要禁用缓存，否则不生效】return;}}
}

3.2. 跨域全局配置方式-SpringMvc

• 重写 WebMvcConfigurer.addCorsMappings()，设置 registry.addMapping(“/**”).allowedOrigins(“*”)等响应头参数（只对SpringMvc写法生效，对原生Servlet不生效）

/** 2.跨域全局配置方式-SpringMvc */
@Configuration
public class WebMvcConfig implements WebMvcConfigurer {@Overridepublic void addCorsMappings(CorsRegistry registry) {registry.addMapping("/**")      // 适配@RequestMapping。 (例如：/ajax/** 开头的)// 下面几个参数，不配置，会使用默认值。origins 和 originPatterns取并集.allowedOrigins("*")                    //【跨域配置】[必需]               允许请求源：默认值为"*"，即允许所有。相当于res.setHeader("Access-Control-Allow-Origin", ).allowedOriginPatterns("*")             //【跨域配置】[必需]               允许请求源：默认值为"*"，即允许所有。相当于res.setHeader("Access-Control-Allow-Origin", ).allowedMethods("*")                    //【跨域配置】[有复杂请求方法时必需]  允许请求方法：默认值为GET,POST,HEAD。相当于res.setHeader("Access-Control-Allow-Methods", ).allowedHeaders("*")                    //【跨域配置】[有复杂请求头时必需]    允许请求头 ：默认值为"*"，即允许所有。相当于res.setHeader("Access-Control-Allow-Headers", ).maxAge(1800);                          //【跨域配置】[非必需]             预检缓存时长：默认值 1800秒。小于等于0时缓存无效【注意浏览器不要禁用缓存，否则不生效】。相当于res.setHeader("Access-Control-Max-Age", )}
}

3.3. 跨域单个配置方式-WebServlet

• 设置 res.addHeader(“Access-Control-Allow-Origin”, “*”) 等响应头参数

/** 3.跨域单个配置方式-WebServlet */
@Slf4j
@WebServlet(name = "ajax", value = {"/ajax/WebServlet", "/ajax/WebServlet/"})
public class AjaxWebServlet extends HttpServlet {@Overrideprotected void service(HttpServletRequest req, HttpServletResponse res) throws IOException {log.warn("method==【{}】, name==【{}】, header.origin==【{}】, Access-Control-Request-Method==【{}】, Access-Control-Request-Headers==【{}】", req.getMethod(), req.getParameter("name"), req.getHeader("Origin"), req.getHeader("Access-Control-Request-Method"), req.getHeader("Access-Control-Request-Headers"));res.setHeader("Access-Control-Allow-Origin", "*");      //【跨域配置】[必需]               允许请求源  ：默认值 无，配置"*"允许所有。res.setHeader("Access-Control-Allow-Methods", "*");     //【跨域配置】[有复杂请求方法时必需]  允许请求方法：默认值 无，配置 "*"，允许所有res.setHeader("Access-Control-Allow-Headers", "*");     //【跨域配置】[有复杂请求头时必需]    允许请求头 ： 默认值 无，配置 "*"，允许所有res.setHeader("Access-Control-Max-Age", "1800");        //【跨域配置】[非必需]             预检缓存时长： 默认值 依赖客户端。EDGE浏览器默认值为3秒。【注意浏览器不要禁用缓存，否则不生效】res.getWriter().write(DateUtil.now() + "@" + req.getMethod());}
}

3.4. 跨域单个配置方式-SpringMvc

• 添加 @CrossOrigin注解，设置origins等响应头参数（只对SpringMvc写法生效，对原生Servlet不生效）

/* 4.跨域单个配置方式-SpringMvc */
@Slf4j
@RestController
@RequestMapping("/ajax")
public class AjaxController {@CrossOrigin(// origins 和 originPatterns取并集。【注意】此处配置与下面的res.setHeader()功能相同，优先级较低。二选其一即可origins = {"*"},            //【跨域配置】[必需]               允许请求源  ：默认值为"*"，即允许所有。相当于res.setHeader("Access-Control-Allow-Origin", )originPatterns = {"*"},     //【跨域配置】[必需]               允许请求源  ：默认值为"*"，即允许所有。相当于res.setHeader("Access-Control-Allow-Origin", )methods = {},               //【跨域配置】[有复杂请求方法时必需]  允许请求方法：默认值为（优先以@RequestMapping的method属性为准，如果没有指定则默认为"GET,POST,HEAD）。相当于res.setHeader("Access-Control-Allow-Methods", )allowedHeaders = {"*"},     //【跨域配置】[有复杂请求头时必需]    允许请求头 ：默认值为"*"，即允许所有。相当于res.setHeader("Access-Control-Allow-Headers", )maxAge = 1800               //【跨域配置】[非必需]             预检缓存时长：默认值 1800秒。小于等于0时缓存无效【注意浏览器不要禁用缓存，否则不生效】 。相当于res.setHeader("Access-Control-Max-Age", ))@RequestMapping(value = "/CrossOrigin", method = {RequestMethod.GET, RequestMethod.PUT})@SneakyThrowsvoid ajax(HttpServletRequest req, HttpServletResponse res) {log.warn("method==【{}】, name==【{}】, header.origin==【{}】, Access-Control-Request-Method==【{}】, Access-Control-Request-Headers==【{}】", req.getMethod(), req.getParameter("name"), req.getHeader("Origin"), req.getHeader("Access-Control-Request-Method"), req.getHeader("Access-Control-Request-Headers"));res.getWriter().write(DateUtil.now() + "@" + req.getMethod());}
}

4.非java实现方式

4.1. nginx代理

• 优点：不用侵入java代码

1. 配置nginx反向代理。在配置文件nginx.conf的http中添加一个server
2. 将AJAX请求通过nginx转发。本例中，将AJAX请求发给58080端口，然后转发给8080端口

server {listen      58080;server_name localhost;location / {proxy_pass http://localhost:8080;# 增加响应头add_header       Access-Control-Allow-Origin  "*";          # 【跨域配置】[必需]               允许请求源  ：默认值 无，配置"*"允许所有。if ($request_method = 'OPTIONS') {          # 如果是复杂请求的预检请求（参考SpringMvc，最好同时判断请求头Origin、Access-Control-Request-Method都不为null，略），设置以下响应头，且没必要透传，直接返回add_header   Access-Control-Allow-Origin  "*";          # 【跨域配置】[必需]               允许请求源  ：默认值 无，配置"*"允许所有。add_header   Access-Control-Allow-Methods "*";          # 【跨域配置】[有复杂请求方法时必需]  允许请求方法：默认值 无，配置 "*"，允许所有add_header   Access-Control-Allow-Headers "*";          # 【跨域配置】[有复杂请求头时必需]    允许请求头 ： 默认值 无，配置 "*"，允许所有add_header   Access-Control-Max-Age "5";                # 【跨域配置】[非必需]             预检缓存时长： 默认值 依赖客户端。EDGE浏览器默认值为3秒。【注意浏览器不要禁用缓存，否则不生效】return 204;}}
}

9. 参考文章

• @CrossOrigin详细参数说明
• SpringBoot处理跨域请求的四种方法