java处理跨域请求

在 Java 后端开发中,跨域问题(CORS,Cross-Origin Resource Sharing)是由于浏览器的同源策略限制,当请求的协议、域名或端口与当前页面不一致时,浏览器会阻止该请求。为解决此问题,Java 提供了多种主流方案,适用于不同框架和场景。


主流解决方案

  • CORS(跨域资源共享):最常用、标准的解决方案,通过设置 HTTP 响应头实现。

  • JSONP:仅支持 GET 请求,适用于老旧系统,但安全性较低,已逐渐淘汰。

  • 代理服务器:如 Nginx 或 Spring Cloud Gateway,将请求转发至目标服务,绕过浏览器限制。

  • 手动设置响应头:在每个控制器方法中添加 CORS 头,适用于简单场景但维护成本高。


常用实现方式(按场景分类)

  1. Spring Boot 项目推荐方式
  • 全局配置(推荐):适用于整个应用统一处理跨域。

```java

@Configuration

public class CorsConfig {

@Bean

public CorsFilter corsFilter() {

CorsConfiguration config = new CorsConfiguration();

config.addAllowedOriginPattern("*"); // 允许所有源,生产环境应指定具体域名

config.addAllowedMethod("*");

config.addAllowedHeader("*");

config.setAllowCredentials(true); // 允许携带凭证(如 Cookie)

UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();

source.registerCorsConfiguration("/**", config);

return new CorsFilter(source);

}

}

```

  • 局部注解(@CrossOrigin):适用于个别接口或控制器。

```java

@RestController

@CrossOrigin(origins = "http://localhost:3000") // 指定允许的源

@RequestMapping("/api")

public class DataController {

@GetMapping("/data")

public String getData() {

return "Cross-origin data";

}

}

```

  • WebMvcConfigurer 配置(Spring MVC 4.2+):

```java

@Configuration

public class CorsConfig implements WebMvcConfigurer {

@Override

public void addCorsMappings(CorsRegistry registry) {

registry.addMapping("/**")

.allowedOrigins("*")

.allowedMethods("GET", "POST", "PUT", "DELETE", "OPTIONS")

.allowedHeaders("*")

.allowCredentials(true)

.maxAge(3600);

}

}

```

  1. 非 Spring 项目(原生 Java Web)

使用 Servlet Filter 拦截所有请求并添加 CORS 头:

```java

@WebFilter("/*")

public class CorsFilter implements Filter {

@Override

public void doFilter(ServletRequest req, ServletResponse res, FilterChain chain)

throws IOException, ServletException {

HttpServletResponse response = (HttpServletResponse) res;

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");

response.setHeader("Access-Control-Max-Age", "3600");

response.setHeader("Access-Control-Allow-Credentials", "true");

if ("OPTIONS".equalsIgnoreCase(((HttpServletRequest) req).getMethod())) {

response.setStatus(HttpServletResponse.SC_OK);

} else {

chain.doFilter(req, res);

}

}

}

```

  1. 使用 Nginx 反向代理(前端/服务端通用)

在 Nginx 配置中添加 CORS 头并代理请求:

```nginx

location / {

add_header 'Access-Control-Allow-Origin' '*';

add_header 'Access-Control-Allow-Methods' 'GET, POST, PUT, DELETE, OPTIONS';

add_header 'Access-Control-Allow-Headers' 'DNT,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Range,Authorization';

if ($request_method = 'OPTIONS') {

add_header 'Access-Control-Allow-Origin' '*';

add_header 'Access-Control-Allow-Methods' 'GET, POST, PUT, DELETE, OPTIONS';

add_header 'Access-Control-Allow-Headers' 'DNT,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Range,Authorization';

add_header 'Access-Control-Max-Age' 1728000;

add_header 'Content-Type' 'text/plain; charset=utf-8';

return 204;

}

proxy_pass http://localhost:8080; 后端 Java 服务地址

}

```


安全注意事项

  • 生产环境避免使用 `Access-Control-Allow-Origin: *`,应明确指定允许的域名。

  • 若需携带凭证(如 Cookie),不能设置 `*`,必须指定具体源,例如:

```java

config.addAllowedOrigin("http://localhost:3000");

config.setAllowCredentials(true);

```

  • 限制 `allowedMethods` 和 `allowedHeaders`,仅开放必要权限。

参考资料

以上方案可根据项目框架(Spring Boot、普通 Servlet、微服务等)和安全需求灵活选择。

相关推荐
Forget the Dream几秒前
Spring AI 2.0 系列(二):第一个 ChatClient——从注入到一次完整调用
java·人工智能·spring boot·ai·springai
黑十2 小时前
FDE 怎么快速搭一个可演示页面?最小前端方案
java·大数据·前端·数据库·人工智能
神明不懂浪漫2 小时前
【第八章】多线程(一)
java·开发语言·经验分享·笔记
用户54817845909502 小时前
Java 与 Python 在大模型与智能体领域的选型
java·python
文丑颜不良啊2 小时前
LeetCode3341~3360题目解析
java·leetcode
hai_android3 小时前
一行 asLiveData,背后是一座生命周期的桥
android·java·kotlin
用户9338104348453 小时前
MyBatis-Plus LambdaQueryWrapper 隐式转换踩坑:不知不觉索引失效
java
用户3721574261353 小时前
Java 在 PDF 中查找关键词:获取页码和坐标,并高亮匹配结果
java
Forget the Dream3 小时前
Spring AI 2.0 系列(三):ChatClient 与 ChatModel:Spring AI 2.0 的两层职责
java·人工智能·spring·springai
Rain的Java大神之路4 小时前
把数组本身变成哈希表:原地哈希搞定 LeetCode 41「缺失的第一个正数」
java·后端·leetcode