SpringBoot跨域及解决方式

最新推荐文章于 2025-04-03 07:49:10 发布

Java劝退师、

最新推荐文章于 2025-04-03 07:49:10 发布

阅读量372

点赞数

CC 4.0 BY-SA版权

本文链接：https://blog.csdn.net/qq_41389354/article/details/132133881

Java 同时被 2 个专栏收录

48 篇文章

订阅专栏

SpringBoot

14 篇文章

订阅专栏

本文聚焦SpringBoot跨域问题，先解释跨域概念，即跨越域名，因同源策略限制不同源资源交互。接着说明解决跨域的必要性，因网站需获取跨域资源。然后介绍两种解决方式，通过CORS配置和自定义Filter，还给出测试用例代码，最后强调按需选方案。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

SpringBoot跨域及解决方式

本文主要讨论SpringBoot的跨域问题以及解决方式，并通过实例代码和测试用例代码来让读者更好理解。在探讨解决方案之前，首先需要解释什么是跨域以及为什么会对其产生限制。

一、什么是跨域?

“跨域”，从字面上理解就是指跨越了域。在这里，“域"是指的是"域名”。在浏览器中，出于安全考虑，同源策略会限制来自不同源（即不同域名、协议或者端口）的"document"或脚本等资源能进行的交互。例如，浏览器允许脚本在用户浏览器内对自身创建的文档或元素进行更改，但是禁止脚本对来自不同源的窗口或文档进行任何操作。

二、为什么需要解决跨域？

随着互联网的发展，为了能够提供更好的用户体验和服务，许多网站需要通过API接口的方式来获取或者操作跨域的资源。然而，浏览器默认的同源策略却限制了这种行为，从而导致了跨域。因此，我们需要对跨域进行处理，从而能够让我们的应用正常的工作。

基于SpringBoot的后台环境中，也有时会遇到前后端分离，前端通过API调用后端服务等情况，这时也会遇到跨域问题。

三、SpringBoot解决跨域的方式

在SpringBoot中，主要有以下两种方式来解决跨域问题：

通过CORS配置解决跨域问题

CORS，全称是"跨域资源共享"（Cross-origin resource sharing）。它是W3C标准，属于浏览器的一种内置机制，通过添加特殊的HTTP头，让浏览器和服务器达成一种"我知道你（浏览器）正在进行跨域，我（服务器）允许你进行跨域，你（浏览器）可以放心发起请求"的明确协议。

在SpringBoot中，我们可以通过配置CORS来解决跨域问题。以下是示例代码：

@Configuration
public class CorsConfig {

    @Bean
    public WebMvcConfigurer corsConfigurer() {
        return new WebMvcConfigurerAdapter() {
            @Override
            public void addCorsMappings(CorsRegistry registry) {
                registry.addMapping("/**")   // 允许跨域访问的路径
                .allowedOrigins("*")         // 允许跨域访问的源
                .allowedMethods("GET", "POST", "PUT", "OPTIONS", "DELETE")
                .allowCredentials(true)
                .maxAge(3600)
                .allowedHeaders("*");
            }
        };
    }
}

以上代码实现了对所有访问路径的CORS配置，允许任意源，任意HTTP方法，同时支持cookies，有效期设为3600秒，可以根据实际业务需求进行调整。

通过Filter解决跨域问题

在SpringBoot中，我们还可以通过编写一个自定义的Filter来解决跨域问题。以下是示例代码：

@Component
public class CorsFilter implements Filter {

    @Override
    public void doFilter(ServletRequest req, ServletResponse res, FilterChain chain) throws IOException, ServletException {
        HttpServletResponse response = (HttpServletResponse) res;
        HttpServletRequest request = (HttpServletRequest) req;
        response.setHeader("Access-Control-Allow-Origin", "*");
        response.setHeader("Access-Control-Allow-Methods", "POST, GET, OPTIONS, DELETE");
        response.setHeader("Access-Control-Max-Age", "3600");
        response.setHeader("Access-Control-Allow-Headers", "*");
        chain.doFilter(req, res);
    }

    @Override
    public void init(FilterConfig filterConfig) {

    }

    @Override
    public void destroy() {

    }
}

以上代码实现了一个自定义的Filter，用于处理所有的HTTP请求，并在处理之前添加了允许任意源的CORS头。这样，我们就可以在应用中任意地方使用这个Filter来处理跨域问题了。

四、测试用例代码

为了验证我们的跨域解决方案是否生效，我们可以通过编写一个简单的测试用例来进行测试。

以下是一个简单的GET请求的测试用例：

@Test
public void testGet() {
    RestTemplate restTemplate = new RestTemplate();
    String url = "http://localhost:8080/api/test";
    ResponseEntity<String> response = restTemplate.getForEntity(url, String.class);
    Assert.assertEquals(200, response.getStatusCodeValue());
}