【Java】解决跨域问题的 8 种方案

最新推荐文章于 2026-06-26 19:40:42 发布

原创最新推荐文章于 2026-06-26 19:40:42 发布 · 379 阅读

13 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

标签

#java #开发语言

🍓 简介：java系列技术分享(👉持续更新中…🔥)
🍓 初衷:一起学习、一起进步、坚持不懈
🍓 如果文章内容有误与您的想法不一致,欢迎大家在评论区指正🙏
🍓 希望这篇文章对你有所帮助,欢迎点赞 👍 收藏 ⭐留言 📝

🍓 更多文章请点击
[

文章目录

前言

前言

在前后端分离开发模式下，跨域（CORS） 是几乎每位开发者都会遇到的前端请求被拦截问题。本文将从跨域原理讲起，一次性整理 Java 后端处理跨域的全局配置、局部控制、网关、代理等全套方案，复制即用，建议收藏。

一、什么是跨域？为什么会出现跨域？

1. 跨域定义

跨域是浏览器基于同源策略做出的安全限制：当请求的协议、域名、端口任意一项与当前页面不同，浏览器就会拦截该请求，导致接口无法正常调用。

2. 同源策略规则

只要有一项不一致，就触发跨域限制。

协议相同（http / https）
域名/IP 相同
端口相同

3. 跨域出现场景

前端地址：http://localhost:8080
后端接口：http://localhost:9090
端口不一致 → 跨域

说明：跨域是浏览器限制，服务器端实际已收到请求并处理，只是浏览器拒绝展示结果。

二、Java/SpringBoot 解决跨域的 8 种方法

1. 全局跨域：注册 CorsFilter Bean

通过注册 CorsFilter 全局过滤器，统一处理所有接口的跨域。

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 GlobalCorsConfig {
    @Bean
    public CorsFilter corsFilter() {
        CorsConfiguration config = new CorsConfiguration();
        config.addAllowedOriginPattern("*");
        config.setAllowCredentials(true);
        config.addAllowedMethod("*");
        config.addAllowedHeader("*");
        config.addExposedHeader("*");

        UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
        source.registerCorsConfiguration("/**", config);
        return new CorsFilter(source);
    }
}

2. 全局跨域：重写 WebMvcConfigurer

实现 WebMvcConfigurer 接口，重写 addCorsMappings 方法，极简全局配置。

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 CorsConfig implements WebMvcConfigurer {
    @Override
    public void addCorsMappings(CorsRegistry registry) {
        registry.addMapping("/**")
                .allowedOriginPatterns("*")
                .allowCredentials(true)
                .allowedMethods("GET", "POST", "OPTIONS", "DELETE", "PUT", "PATCH")
                .maxAge(3600);
    }
}

3. 局部跨域：@CrossOrigin 注解

作用在类上：

@RestController
@CrossOrigin(origins = "*")
public class TestController {
}

作用在方法上：
@PostMapping("/user/login")
@CrossOrigin(origins = "*")
public String login() {
    return "success";
}

4. 局部跨域：手动设置响应头

import javax.servlet.http.HttpServletResponse;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HeaderController {
    @GetMapping("/test/header")
    public String test(HttpServletResponse response) {
        response.setHeader("Access-Control-Allow-Origin", "*");
        response.setHeader("Access-Control-Allow-Methods", "*");
        return "ok";
    }
}

5. 自定义 Filter 实现跨域

import org.springframework.context.annotation.Configuration;
import javax.servlet.*;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;

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

6. Spring Cloud Gateway 网关跨域

spring:
  cloud:
    gateway:
      # 。。。
      globalcors: # 全局的跨域处理
        add-to-simple-url-handler-mapping: true # 解决options请求被拦截问题
        corsConfigurations:
          '[/**]':
            allowedOrigins: # 允许哪些网站的跨域请求 
              - "http://localhost:8090"
            allowedMethods: # 允许的跨域ajax的请求方式
              - "GET"
              - "POST"
              - "DELETE"
              - "PUT"
              - "OPTIONS"
            allowedHeaders: "*" # 允许在请求中携带的头信息
            allowCredentials: true # 是否允许携带cookie
            maxAge: 360000 # 这次跨域检测的有效期

7. Nginx 代理解决跨域

server {
    listen 80;
    server_name localhost;
    location / {
        add_header Access-Control-Allow-Origin *;
        add_header Access-Control-Allow-Methods GET,POST,OPTIONS,DELETE,PUT;
        add_header Access-Control-Allow-Headers *;
        if ($request_method = OPTIONS) {
            return 204;
        }
        proxy_pass http://127.0.0.1:9090;
    }
}

8. 拦截器方式实现跨域

import org.springframework.web.servlet.handler.HandlerInterceptorAdapter;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

@Component
public class CrossInterceptor extends HandlerInterceptorAdapter {
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) {
        response.setHeader("Access-Control-Allow-Origin", "*");
        response.setHeader("Access-Control-Allow-Methods", "GET,POST,PUT,DELETE,OPTIONS");
        response.setHeader("Access-Control-Max-Age", "3600");
        response.setHeader("Access-Control-Allow-Headers", "*");
        response.setHeader("Access-Control-Allow-Credentials", "true");
        return true;
    }
}