Spring Boot 跨域解决方案：实战技巧与案例分析
随着互联网技术的不断发展，前后端分离的架构模式已经成为Web开发的主流。在这样的大背景下，跨域资源共享（Cross-Origin Resource Sharing，简称CORS）成为了前端开发者必须面对的问题。Spring Boot作为一款流行的Java框架，提供了多种跨域解决方案。本文将深入探讨Spring Boot的跨域方案，并通过实际案例进行讲解。
一、Spring Boot跨域解决方案概述
1. 原生方法：通过在Spring Boot配置文件中添加CORS相关配置，实现跨域访问。
2. 使用第三方库：借助如`spring-boot-starter-cors`等第三方库，简化CORS配置。
3. 自定义过滤器：通过自定义过滤器实现CORS，具有更高的灵活性。
二、原生方法：配置文件实现跨域
1. 在Spring Boot项目中，创建一个配置类，继承`WebMvcConfigurer`接口。
2. 在配置类中重写`addCorsMappings`方法，配置CORS相关参数。
以下是一个简单的示例：
```java
@Configuration
public class WebConfig implements WebMvcConfigurer {
@Override
public void addCorsMappings(CorsRegistry registry) {
registry.addMapping("/**")
.allowedOrigins("*")
.allowedMethods("GET", "POST", "PUT", "DELETE", "OPTIONS")
.allowedHeaders("*")
.allowCredentials(true);
}
}
```
在上述代码中，`/**`表示所有路径都允许跨域访问。`allowedOrigins("*")`表示允许所有域名访问，实际项目中应替换为具体的域名。`allowedMethods`表示允许的HTTP方法，`allowedHeaders`表示允许的头部信息，`allowCredentials`表示是否允许携带凭证。
三、使用第三方库：简化CORS配置
1. 在`pom.xml`文件中添加`spring-boot-starter-cors`依赖。
```xml
```
2. 在Spring Boot启动类上添加`@EnableCORS`注解。
```java
@SpringBootApplication
@EnableCORS
public class DemoApplication {
public static void main(String[] args) {
SpringApplication.run(DemoApplication.class, args);
}
}
```
使用第三方库后，CORS配置将自动生效，无需手动添加配置类。
四、自定义过滤器：实现灵活的跨域方案
1. 创建一个过滤器类，继承`OncePerRequestFilter`。
2. 在过滤器中重写`doFilterInternal`方法，添加CORS相关处理。
以下是一个简单的示例：
```java
@Component
public class CORSFilter extends OncePerRequestFilter {
@Override
protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain filterChain) throws ServletException, IOException {
response.setHeader("Access-Control-Allow-Origin", "*");
response.setHeader("Access-Control-Allow-Methods", "GET, POST, PUT, DELETE, OPTIONS");
response.setHeader("Access-Control-Allow-Headers", "Content-Type,Authorization,Access-Control-Allow-Origin,Access-Control-Allow-Credentials");
response.setHeader("Access-Control-Allow-Credentials", "true");
filterChain.doFilter(request, response);
}
}
```
在上述代码中，通过设置响应头实现了CORS跨域访问。实际项目中，可以根据需求调整响应头的参数。
五、案例分析
以下是一个使用原生方法实现跨域的简单案例：
1. 创建一个Spring Boot项目，添加必要的依赖。
2. 创建一个控制器类，处理跨域请求。
```java
@RestController
@RequestMapping("/api")
public class CORSController {
@GetMapping("/test")
public String test() {
return "Hello, CORS!";
}
}
```
3. 在Spring Boot配置类中添加CORS相关配置。
```java
@Configuration
public class WebConfig implements WebMvcConfigurer {
@Override
public void addCorsMappings(CorsRegistry registry) {
registry.addMapping("/**")
.allowedOrigins("*")
.allowedMethods("GET", "POST", "PUT", "DELETE", "OPTIONS")
.allowedHeaders("*")
.allowCredentials(true);
}
}
```
4. 启动Spring Boot项目，访问`http://localhost:8080/api/test`，即可看到跨域请求的结果。
通过以上案例，我们可以看到，使用Spring Boot实现跨域解决方案非常简单。在实际项目中，可以根据需求选择合适的跨域方案，以提高开发效率和项目质量。
