一文盘点SpringBoot中常用跨域处理方案

 更新时间:2025年08月26日 08:51:24   作者:ningqw  
跨域是浏览器为了保障安全而遵循的一种规则,是同源策略的一部分,本文将为大家整理了SpringBoot中常用跨域处理的方法,需要的小伙伴可以了解下

1.什么是跨域

跨域是浏览器为了保障安全而遵循的一种规则,是同源策略的一部分。

  • 同源:要求协议、域名、端口三者完全相同。
  • 跨域:只要协议、域名、端口中有任何一个不同,浏览器就会判定为跨域请求。

跨域(Cross-Origin)是浏览器独有的安全策略,不存在于安卓、iOS、Node.js、Python、Java 等原生客户端或服务器端环境中。因为浏览器是一个开放的、执行不可信代码,也就是各个网站的 js 脚本的环境,同源策略是为了保证用户的信息安全。

所以,如果平时测试接口用的是 postman 发送请求,不需要关心跨域问题,但是如果是前后端联调就必须处理跨域问题。

2.浏览器处理跨域请求的方式

浏览器遵循同源策略,不允许页面获取跨域请求返回的响应结果。

比如:当前网页是 http://127.0.0.1:63342,然后向服务器 http://127.0.0.1:8080 发送 GET 请求获取数据。整个过程分成三步:

  • 浏览器发送请求
  • 服务器接收请求,处理业务,返回响应
  • 浏览器获取服务器返回的响应并根据响应渲染页面

无论是跨域请求还是非跨域请求,浏览器都可以发送给服务器,并且接收服务器返回的响应数据。

  • 如果该请求是非跨域请求,则 js 脚本可以访问响应数据
  • 如果该请求是跨域请求,浏览器会拦截响应数据,不让 js 访问这些数据

其实浏览器可以向不同的域名发送请求,但是浏览器会拦截响应内容,不让 js 访问,无论请求是否成功。

3.跨域处理方案

跨域处理的核心:让浏览器不要拦截跨域请求返回的数据。

服务器的响应中如果有 Access-Control-Allow-Origin: * 这个响应头,就是告诉浏览器:"我是服务器,虽然我跟这个网页不是同源的,但是我允许这个网页跟我通信,我们之间的通信是安全的",浏览器就不会拦截 js 对响应数据的访问。

浏览器发送的请求可以分为简单请求和复杂请求:

  • 如果是简单请求,则浏览器直接发送。
  • 如果是复杂请求,则浏览器先发送一个预检请求,即 OPTIONS 请求,问一句:"我可以发送一个超级复杂的跨域请求吗?",服务器需要返回针对 OPTIONS 的响应。如果服务器允许发送这个复杂请求,浏览器才会真正发送请求。

常见的跨域处理方案有:代理服务器、后端服务器跨域配置。

3.1代理服务器

浏览器将请求发送到跟页面同源的代理服务器,代理服务器再将请求转发到目标服务器。因为服务器间通信不受同源策略限制。比如常见的用 nginx 作为代理服务器。

请求处理过程:

  • 前端发送请求,请求经过 nginx,请求被转发到后端服务器。
  • 服务器返回原始响应,原始响应经过 nginx,nginx 自动添加 Access-Control-Allow-Origin: * 响应头,响应返回给前端,js 可以访问响应数据。
# nginx.conf
server {
    listen 63342;
    # 前端页面的域名或ip
    server_name 127.0.0.1;

    # 代理所有以 /api/ 开头的请求到后端服务器
    location /api/ {
        # 后端服务器地址
        proxy_pass http://127.0.0.1:8080/; 

        # 修改请求头,确保后端能收到正确的原始主机信息
        proxy_set_header Host $host; 
        proxy_set_header X-Real-IP $remote_addr; 
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; 
        proxy_set_header X-Forwarded-Proto $scheme;

        # 添加CORS响应头,允许所有来源的请求,生产环境应关闭
        add_header 'Access-Control-Allow-Origin' '*'; 
        
        # 允许的请求方法
        add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS, PUT, DELETE, PATCH';
        
        if ($request_method = 'OPTIONS') {
            # 对于OPTIONS请求,直接返回204状态码,不需要转发到后端
            return 204;
        }
    }
}

3.2 后端跨域配置

3.2.1 配置 CORS

配置全局 CORS 规则,在所有响应头都配置可以跨域访问。

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 WebMvcConfig implements WebMvcConfigurer {
    @Override
    public void addCorsMappings(CorsRegistry registry) {
        registry.addMapping("/**") // 允许所有接口跨域
                .allowCredentials(true) // 允许浏览器在跨域请求中发送认证信息
                .allowedOriginPatterns("*") // 允许访问资源的源(协议、域名、端口)
                .allowedMethods("GET", "POST", "PUT", "DELETE", "OPTIONS") // 允许的方法
                .allowedHeaders("*") // 允许的请求头
                .exposedHeaders("*"); // 哪些响应头可以暴露给前端js
    }
}

3.2.2 提供 CorsFilter

提供一个 CorsFilter 的 Bean 作为过滤器。

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() {
        CorsConfiguration config = new CorsConfiguration();

        config.addAllowedOriginPattern("*"); // 放行所有域名,生产环境请对此进行修改

        config.setAllowCredentials(true); // 是否发送cookie

        config.addAllowedMethod("*");  // 放行的请求方式

        config.addAllowedHeader("*"); // 放行的请求头

        config.addExposedHeader("*"); // 暴露头部信息

        // UrlBasedCorsConfigurationSource: 可以为不同的URL路径设置不同的CORS规则
        UrlBasedCorsConfigurationSource corsConfigurationSource = new UrlBasedCorsConfigurationSource();
        // 所有的URL路径都使用同一个CORS规则
        corsConfigurationSource.registerCorsConfiguration("/**", config);

        return new CorsFilter(corsConfigurationSource);
    }
}

3.2.3 @CrossOrigin 注解

在接口类上或者接口方法上添加 @CrossOrigin 注解,表示整个类、单个接口的响应不会被拦截。

@RestController
@CrossOrigin
public class DemoController {

    @PutMapping("/put")
    public Integer put(MultipartFile file) {
        System.out.println(file.getOriginalFilename());
        return 200;
    }

    @GetMapping("/get")
    public Integer get() {
        return 200;
    }
}

到此这篇关于一文盘点SpringBoot中常用跨域处理方案的文章就介绍到这了,更多相关SpringBoot跨域处理内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • idea install 时提示jdk的某个jar包的包不存在的问题

    idea install 时提示jdk的某个jar包的包不存在的问题

    这篇文章主要介绍了idea install 时提示jdk的某个jar包的包不存在的问题,本文给大家分享解决方法,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-09-09
  • SpringAI Agent开发秘籍如何让javaer也可以用上Agent Skills

    SpringAI Agent开发秘籍如何让javaer也可以用上Agent Skills

    文章介绍了如何使用SpringA和Skills构建一个代码评审应用,通过实战示例展示如何利用SpringAI和大模型实现零配置的代码评审功能,感兴趣的朋友跟随小编一起看看吧
    2026-04-04
  • SpringBoot动态修改配置的十种方法

    SpringBoot动态修改配置的十种方法

    在SpringBoot应用中,配置信息通常通过application.properties或application.yml文件静态定义,应用启动后这些配置就固定下来了,但我们常常需要在不重启应用的情况下动态修改配置,本文将介绍SpringBoot中10种实现配置动态修改的方法,需要的朋友可以参考下
    2025-05-05
  • Elasticsearch模糊查询详细介绍

    Elasticsearch模糊查询详细介绍

    这篇文章主要给大家介绍了关于Elasticsearch模糊查询的相关资料,在数据库查询中模糊查询是一种强大的技术,可以用来搜索与指定模式匹配的数据,需要的朋友可以参考下
    2023-09-09
  • Java判断中英文符号、标点的实现

    Java判断中英文符号、标点的实现

    本篇文章主要介绍了Java判断中英文符号、标点的实现,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-10-10
  • Java TreeMap排序算法实例

    Java TreeMap排序算法实例

    这篇文章主要介绍了Java TreeMap排序算法,结合实例形式分析了TreeMap排序算法的原理、实现方法与相关注意事项,需要的朋友可以参考下
    2017-07-07
  • 使用Java实现一个简单的定时器

    使用Java实现一个简单的定时器

    这篇文章主要为大家详细介绍了如何使用Java实现一个简单的延时/定时器,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下
    2024-12-12
  • Java设计模式之命令模式详细解析

    Java设计模式之命令模式详细解析

    这篇文章主要介绍了Java设计模式之命令模式详细解析,命令模式将请求封装成对象,以便使用不同的请求、队列或者日志来参数化其他对象,同时也支持可撤销的操作,需要的朋友可以参考下
    2024-01-01
  • 浅谈JVM闪崩问题定位排查

    浅谈JVM闪崩问题定位排查

    JVM闪崩指Java进程异常退出,表现为进程消失、可能生成错误日志或coredump,下面就来介绍一下闪崩问题定位排查,感兴趣的可以了解一下
    2025-12-12
  • Java反射 Field类的使用全方位解析

    Java反射 Field类的使用全方位解析

    这篇文章主要介绍了Java反射 Field类的使用全方位解析,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2021-04-04

最新评论