百度360必应搜狗淘宝本站头条
python类型转换python串口编程python计时python异常python进度条
当前位置：网站首页 > 技术资源 > 正文

解决跨域问题的8种方法，含网关、Nginx和SpringBoot~

off999 2025-02-07 18:44 51 浏览 0 评论

跨域问题是浏览器为了保护用户的信息安全，实施了同源策略（Same-Origin Policy），即只允许页面请求同源（相同协议、域名和端口）的资源，当 JavaScript 发起的请求跨越了同源策略，即请求的目标与当前页面的域名、端口、协议不一致时，浏览器会阻止请求的发送或接收。

解决跨域问题方案

跨域问题可以从以下方面解决：

  1. 应用层面解决：例如 Spring Boot 项目中解决跨域问题。
  2. 反向代理解决：例如 Nginx 中解决跨域问题。
  3. 网关中解决：例如 Spring Cloud Gateway 中解决跨域问题。

而这 3 类解决方案，总共包含了 8 种解决方案，一起来看。

1.Spring Boot 中解决跨域

在 Spring Boot 中跨域问题有以下 5 种解决方案：

  1. 使用 @CrossOrigin 注解实现跨域【局域类跨域】
  2. 通过配置文件实现跨域【全局跨域】
  3. 通过 CorsFilter 对象实现跨域【全局跨域】
  4. 通过 Response 对象实现跨域【局域方法跨域】
  5. 通过实现 ResponseBodyAdvice 实现跨域【全局跨域】

接下来详细来看。

1.1 通过注解跨域

使用 @CrossOrigin 注解可以轻松的实现跨域，此注解既可以修饰类，也可以修饰方法。当修饰类时，表示此类中的所有接口都可以跨域；当修饰方法时，表示此方法可以跨域，它的实现如下：

import org.springframework.web.bind.annotation.CrossOrigin;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import java.util.HashMap;
@RestController
@CrossOrigin(origins = "*")
public class TestController {
    @RequestMapping("/test")
    public HashMap test() {
        return new HashMap() {{
            put("state", 200);
            put("data", "success");
            put("msg", "");
        }};
    }
}

以上代码的执行结果如下图所示：

从上图中可以看出，前端项目访问另一个后端项目成功了，也就说明它解决了跨域问题。


优缺点分析

此方式虽然虽然实现（跨域）比较简单，但细心的朋友也能发现，使用此方式只能实现局部跨域，当一个项目中存在多个类的话，使用此方式就会比较麻烦（需要给所有类上都添加此注解）。

1.2 通过配置文件跨域

通过设置配置文件的方式就可以实现全局跨域了，它的实现步骤如下：

  • 创建一个新配置文件。
  • 添加 @Configuration 注解，实现 WebMvcConfigurer 接口。
  • 重写 addCorsMappings 方法，设置允许跨域的代码。

具体实现代码如下：

import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.CorsRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

@Configuration // 一定不要忽略此注解
public class CorsConfig implements WebMvcConfigurer {
    @Override
    public void addCorsMappings(CorsRegistry registry) {
        registry.addMapping("/**") // 所有接口
        .allowCredentials(true) // 是否发送 Cookie
        .allowedOriginPatterns("*") // 支持域
        .allowedMethods(new String[]{"GET", "POST", "PUT", "DELETE"}) // 支持方法
        .allowedHeaders("*")
        .exposedHeaders("*");
    }
}

1.3 通过 CorsFilter 跨域

此实现方式和上一种实现方式类似，它也可以实现全局跨域，它的具体实现代码如下：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.cors.CorsConfiguration;
import org.springframework.web.cors.UrlBasedCorsConfigurationSource;
import org.springframework.web.filter.CorsFilter;

@Configuration // 一定不能忽略此注解
public class MyCorsFilter {
    @Bean
    public CorsFilter corsFilter() {
        // 1.创建 CORS 配置对象
        CorsConfiguration config = new CorsConfiguration();
        // 支持域
        config.addAllowedOriginPattern("*");
        // 是否发送 Cookie
        config.setAllowCredentials(true);
        // 支持请求方式
        config.addAllowedMethod("*");
        // 允许的原始请求头部信息
        config.addAllowedHeader("*");
        // 暴露的头部信息
        config.addExposedHeader("*");
        // 2.添加地址映射
        UrlBasedCorsConfigurationSource corsConfigurationSource = new UrlBasedCorsConfigurationSource();
        corsConfigurationSource.registerCorsConfiguration("/**", config);
        // 3.返回 CorsFilter 对象
        return new CorsFilter(corsConfigurationSource);
    }
}

1.4 通过 Response 跨域

此方式是解决跨域问题最原始的方式，但它可以支持任意的 Spring Boot 版本（早期的 Spring Boot 版本也是支持的）。但此方式也是局部跨域，它应用的范围最小，设置的是方法级别的跨域，它的具体实现代码如下：

import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import javax.servlet.http.HttpServletResponse;
import java.util.HashMap;
@RestController
public class TestController {
    @RequestMapping("/test")
    public HashMap test(HttpServletResponse response) {
        // 设置跨域
        response.setHeader("Access-Control-Allow-Origin", "*");
        return new HashMap() {{
            put("state", 200);
            put("data", "success");
            put("msg", "");
        }};
    }
}

1.5 通过 ResponseBodyAdvice 跨域

通过重写 ResponseBodyAdvice 接口中的 beforeBodyWrite（返回之前重写）方法，我们可以对所有的接口进行跨域设置，它的具体实现代码如下：

import org.springframework.core.MethodParameter;
import org.springframework.http.MediaType;
import org.springframework.http.server.ServerHttpRequest;
import org.springframework.http.server.ServerHttpResponse;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.servlet.mvc.method.annotation.ResponseBodyAdvice;

@ControllerAdvice
public class ResponseAdvice implements ResponseBodyAdvice {
    /**
     * 内容是否需要重写（通过此方法可以选择性部分控制器和方法进行重写）
     * 返回 true 表示重写
     */
    @Override
    public boolean supports(MethodParameter returnType, Class converterType) {
        return true;
    }
    /**
     * 方法返回之前调用此方法
     */
    @Override
    public Object beforeBodyWrite(Object body, MethodParameter returnType, MediaType selectedContentType,
                                  Class selectedConverterType, ServerHttpRequest request,
                                  ServerHttpResponse response) {
        // 设置跨域
        response.getHeaders().set("Access-Control-Allow-Origin", "*");
        return body;
    }
}

此实现方式也是全局跨域，它对整个项目中的所有接口有效。

2.Nginx 中解决跨域

在 Nginx 服务器的配置文件中添加以下代码：

server {
    listen       80;
    server_name  your_domain.com;
    location /api {
        # 允许跨域请求的域名，* 表示允许所有域名访问
        add_header 'Access-Control-Allow-Origin' '*';

        # 允许跨域请求的方法
        add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS';

        # 允许跨域请求的自定义 Header
        add_header 'Access-Control-Allow-Headers' 'Origin, X-Requested-With, Content-Type, Accept';

        # 允许跨域请求的 Credential
        add_header 'Access-Control-Allow-Credentials' 'true';

        # 预检请求的存活时间，即 Options 请求的响应缓存时间
        add_header 'Access-Control-Max-Age' 3600;

        # 处理预检请求
        if ($request_method = 'OPTIONS') {
            return 204;
        }
    }
    # 其他配置...
}

上述示例中，location /api 代表配置针对 /api 路径的请求进行跨域设置。可以根据具体需要修改 location 的值和其他相关参数。配置中的 add_header 指令用于设置响应头部，常用的响应头部包括以下这些：

  • Access-Control-Allow-Origin：用于指定允许跨域的域名，可以设置为 * 表示允许所有域名访问。
  • Access-Control-Allow-Methods：用于指定允许的跨域请求的方法，例如 GET、POST、OPTIONS 等。
  • Access-Control-Allow-Headers：用于指定允许的跨域请求的自定义 Header。
  • Access-Control-Allow-Credentials：用于指定是否允许跨域请求发送和接收 Cookie。
  • Access-Control-Max-Age：用于设置预检请求（OPTIONS 请求）的响应缓存时间。

3.网关中解决跨域

Spring Cloud Gateway 中解决跨域问题可以通过以下两种方式实现：

  1. 通过在配置文件中配置跨域实现。
  2. 通过在框架中添加 CorsWebFilter 来解决跨域问题。

3.1 配置文件中设置跨域

在 application.yml 或 application.properties 中添加以下配置：

spring:
  cloud:
    gateway:
      globalcors:
        corsConfigurations:
          '[/**]': # 这里的'/**'表示对所有路由生效，可以根据需要调整为特定路径
            allowedOrigins: "*" # 允许所有的源地址，也可以指定具体的域名
            allowedMethods: # 允许的 HTTP 方法类型
              - GET
              - POST
              - PUT
              - DELETE
              - OPTIONS
            allowedHeaders: "*" # 允许所有的请求头，也可以指定具体的请求头
            allowCredentials: true # 是否允许携带凭证（cookies）
            maxAge: 3600 # CORS预检请求的有效期（秒）

其中：

  • allowedOrigins: 设置允许访问的来源域名列表，"*" 表示允许任何源。
  • allowedMethods: 指定哪些HTTP方法可以被用于跨域请求。
  • allowedHeaders: 客户端发送的请求头列表，"*" 表示允许任何请求头。
  • allowCredentials: 当设为 true 时，允许浏览器在发起跨域请求时携带认证信息（例如 cookies）。
  • maxAge: 预检请求的结果可以在客户端缓存的最大时间。

通过这样的配置，Spring Cloud Gateway 网关将自动处理所有经过它的跨域请求，并添加相应的响应头，从而允许前端应用执行跨域请求。

3.2 添加 CorsWebFilter 来解决跨域问题

在 Spring-Framework 从 5.3 版本之前，使用以下代码可以让 Spring Cloud Gateway 网关允许跨域：

@Configuration
public class GlobalCorsConfig {
    @Bean
    public CorsWebFilter corsWebFilter() {
        CorsConfiguration config = new CorsConfiguration();
        // 这里仅为了说明问题，配置为放行所有域名，生产环境请对此进行修改
        config.addAllowedOrigin("*");
        // 放行的请求头
        config.addAllowedHeader("*");
        // 放行的请求类型，有 GET, POST, PUT, DELETE, OPTIONS
        config.addAllowedMethod("*"); 
        // 暴露头部信息
        config.addExposedHeader("*"); 
        // 是否允许发送 Cookie
        config.setAllowCredentials(true); 
        UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
        source.registerCorsConfiguration("/**", config);
        return new CorsWebFilter(source);
    }
}

而 Spring-Framework 5.3 版本之后，关于 CORS 跨域配置类 CorsConfiguration 中将 addAllowedOrigin 方法名修改为 addAllowedOriginPattern，因此配置了变成了以下这样：

@Configuration
public class GlobalCorsConfig {

    @Bean
    public CorsWebFilter corsWebFilter() {
        CorsConfiguration config = new CorsConfiguration();
        // 这里仅为了说明问题，配置为放行所有域名，生产环境请对此进行修改
        config.addAllowedOriginPattern("*");
        // 放行的请求头
        config.addAllowedHeader("*");
        // 放行的请求类型，有 GET, POST, PUT, DELETE, OPTIONS
        config.addAllowedMethod("*"); 
        // 暴露头部信息
        config.addExposedHeader("*"); 
        // 是否允许发送 Cookie
        config.setAllowCredentials(true); 
        UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
        source.registerCorsConfiguration("/**", config);
        return new CorsWebFilter(source);
    }
}

小结

跨域问题可以在网关层、反向代理层或应用层来解决，而它们的使用优先级是：网关层 > 代理层 > 应用层。因为越靠前覆盖范围就越大，解决跨域问题就越容易。

课后思考

为什么跨域问题竟有 8 种解决方案？这 8 种解决方案有没有相同之处？跨域问题的本质是啥？

欢迎评论区，写出你的答案。点赞过 50，更新下一篇文章，谢谢大家！

本文已收录到我的面试小站 [www.javacn.site](https://www.javacn.site)，其中包含的内容有：Redis、JVM、并发、并发、MySQL、Spring、Spring MVC、Spring Boot、Spring Cloud、MyBatis、设计模式、消息队列等模块。

相关推荐

win732位系统多大（win732位系统支持多大硬盘）

您好，32位Windows7的所有版本均支持4GB内存，但32位的Windows7实际可利用的最大内存只有3.25GB左右。64位的Windows7家庭普通版能支持8GB内存，家庭高级版能支持1...

win10修改电脑开机密码（win10修改电脑开机密码在哪里）

win10系统这样重设开机密码：具体的步骤如下：1、点击Win10的“开始”按钮，继续点击“设置”选项。2、点击“账户”选项。3、点击左侧的“登录选项”，接着在“密码”选项下点击“更改”。4、首先会弹...

办公软件office下载（office办公软件正版下载）

office字体都变成了英文是因为设置了英文模式。具体的解决步骤如下：我们需要准备的材料分别是：电脑、Word文档。1、首先我们打开Word文档，点击打开左上角的文件中的“选项”。2、然后我们在弹出来...

windows打开注册表（windows打开注册表编辑器的命令）

如果装了杀毒软件，并且开了注册表保护功能，关闭此功能，如果关闭后可以正常写入了，说明是这个问题造成的，之所以打开后不能写入了，是由于注册表保护功能的提示项目被关闭了，打开设置项目，打开提示即可，这样以...

win7本地组策略编辑器怎么打开

1、在桌面上新建一个记事本文件，随后双击打开它将下方的代码全部复制粘贴进去：　　@echooff　　pushd"%~dp0"　　dir/bC:\Windows\servicing\Packag...

笔记本连接不上无线网（笔记本连接不上无线网络）

1、笔记本电脑连不上wifi原因有很多，如果是所有WIFI都连接不上，那就是电脑自身设置出错。2、方法一：电脑连不上wifi，图标会有黄色叹号，在右下角右键点击无线wifi图标，再点击打开网络和共享中...

国内杀毒软件（国内杀毒软件有哪些完整名单）

小米手机自带的安全中心中就有病毒扫描功能，可能小米与360不太兼容，不过我觉得小米自带的杀毒也可以的，不用再单独下载一个杀毒软件了，我觉得是软件问题，因为有的软件手机是不支持的，强行安装后就会出现启动...

tplink18r18e如何设置（tplink19216811路由器设置）

TL-H28R路由器恢复了出厂设置，现在要设置其连接宽带上网，需要经过以下几个步骤：1、TL-H28R路由器与TL-H28E扩展器注册；将TL-H28R路由器和TL-H28E扩展器分别插到电源插座上，...

win7现在还能用吗（win7现在还能用么2021年）
win7现在还能用吗（win7现在还能用么2021年）

WINDOWS7系统还可以用多久？什么时候会被淘汰？先不说WINDOWS7系统可以用多久，先说说XP系统到目前为止可以在系统之家上搜索，并且下载，只要硬件支持，XP系统都可以继续在使用，也不用担心，XP系统在使用的过程中系统出现崩溃或者...

2025-12-03 21:03 off999

免费下载升级（免费下载升级拖拉机两副牌80分）

以创维E530E系列为例：1、第一步：到创维社区下载官方本地升级包，将升级包放到U盘的根目录下，不能放到文件夹中否则检测不到升级包2、将U盘插入电视背后的USB接口。插上U盘后，电视会检测到U盘，选择...

win10家庭版是多少位（win10家庭版是32位吗）

win10家庭版包含32位win10家庭版和64位win10家庭版。32位操作系统针对的32位的CPU设计。CPU内部寄存器和寻址总线是32位，指令集可以运行32位数据指令，也就是说一次可以提取32位...

联想投诉电话人工服务（联想总部投诉热线95539有用吗）

投诉某家联想售后服务中心的话，你可以按照以下步骤来进行操作：1.收集证据：整理好所有的证据材料，包括维修单据、交流记录、照片或视频等，以便提供给投诉部门。2.联系联想客服：首先，你可以尝试通过联想...

win7旗舰版bios设置（win7旗舰版bios设置教程）

Win7旗舰版的BIOS高级模式指的是进入计算机主板的BIOS（基本输入输出系统）设置中的一种模式，该模式提供了更高级的设置选项，可以更好地控制硬件性能和外设的功能。高级模式比标准模式更加复杂，需要进...

怎么设置自己家的wifi（怎样设置自己家的wifi）

要设置家里的WiFi，首先确保你有一个无线路由器。将路由器连接到宽带调制解调器，并通过网线连接到电脑。打开浏览器，输入路由器的默认IP地址，登录路由器的管理界面。根据路由器的说明书，设置WiFi名称（...

xp万能驱动下载（winxp万能驱动）

查看自己打印机的型号，然后去官网下载对应的驱动使用纯净版XP系统的时候还要安装声卡驱动，当我们对这个方面的驱动都完全的安装好了之后，这样才可以更好地保障今后的使用。电脑之中，只是安装系统还是无法使用的...

取消回复欢迎 你 发表评论:

一周热门
最近发表
标签列表
Copyright Your WebSite.Some Rights Reserved.