### 如何在
Spring Boot中通过
拦截器实现
跨域配置
#### 1.
拦截器与
跨域的关系
在
Spring Boot中，虽然可以通过`@CrossOrigin`注解或全局过滤器来
解决跨域问题[^2]，但也可以利用
拦截器完成类似的逻辑。
拦截器可以在请求到达控制器之前对其进行预处理，因此非常适合用来
设置响应头以支持
跨域。
---
#### 2. 实现步骤
##### (1) 创建
Spring Boot项目并引入依赖
确保
项目的`pom.xml`文件中有以下依赖项：
```xml
<dependency>
<groupId>org.
springframework.
boot</groupId>
<artifactId>
spring-
boot-starter-web</artifactId>
</dependency>
```
---
##### (2) 定义
拦截器类
创建一个自定义
拦截器类，继承`HandlerInterceptor`接口，并重写其方法：
```java
import org.
springframework.stereotype.Component;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
@Component
public class CorsInterceptor implements org.
springframework.web.servlet.HandlerInterceptor {
@Override
public boolean
preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
//
设置允许的源、方法和头部字段
response.setHeader("Access-Control-Allow-Origin", "*");
response.setHeader("Access-Control-Allow-Methods", "POST, GET, OPTIONS, DELETE, PUT");
response.setHeader("Access-Control-Max-Age", "3600");
response.setHeader("Access-Control-Allow-Headers", "Content-Type, Authorization, X-Requested-With");
// 如果是OPTIONS请求，则直接返回成功状态码
if ("OPTIONS".equalsIgnoreCase(request.getMethod())) {
response.setStatus(HttpServletResponse.SC_OK);
return false; // 不继续向下执行
}
return true; // 继续后续操作
}
}
```
上述代码
设置了必要的
跨域响应头，并针对`OPTIONS`预检请求进行了特殊处理[^4]。
---
##### (3) 注册
拦截器
通过实现`WebMvcConfigurer`接口并将
拦截器注册到
Spring容器中：
```java
import org.
springframework.beans.factory.annotation.Autowired;
import org.
springframework.context.annotation.Configuration;
import org.
springframework.web.servlet.config.annotation.InterceptorRegistry;
import org.
springframework.web.servlet.config.annotation.WebMvcConfigurer;
@Configuration
public class WebConfig implements WebMvcConfigurer {
private final CorsInterceptor corsInterceptor;
@Autowired
public WebConfig(CorsInterceptor corsInterceptor) {
this.corsInterceptor = corsInterceptor;
}
@Override
public void addInterceptors(InterceptorRegistry registry) {
// 添加
拦截器并指定路径规则
registry.addInterceptor(corsInterceptor)
.addPathPatterns("/**") // 拦截所有请求
.excludePathPatterns("/api/auth/**"); // 排除认证相关路径[^5]
}
}
```
---
##### (4) 测试
跨域功能
编写一个简单的控制器测试
跨域效果：
```java
import org.
springframework.web.bind.annotation.GetMapping;
import org.
springframework.web.bind.annotation.RestController;
@RestController
public class TestController {
@GetMapping("/test")
public String test() {
return "This is a cross-origin test!";
}
}
```
启动应用程序后，尝试从其他
域名发起GET请求至`/test`端点，验证是否能够正常接收数据。
---
### 总结
以上展示了如何借助
Spring Boot中的
拦截器实现
跨域配置的过程。相比传统的XML方式更加简洁高效，同时也保留了灵活性，便于开发者根据实际需求调整路径匹配规则或其他参数[^1]。
---
本文详细介绍了在SpringBoot项目中，如何通过在拦截器的preHandle方法中正确设置响应头来解决跨域问题。特别指出，在withCredentials为true的情况下，Access-Control-Allow-Credentials必须设为true，且Access-Control-Allow-Origin不能设置为*。
扫一扫
638
到【灌水乐园】发言
