Java跨域问题分析与解决方法详解

2023-05-20 05:58

短信预约 -IT技能 免费直播动态提醒

一、前言

随着 Web 技术的不断发展，前后端分离的开发模式逐渐成为主流。在这种模式下，前端和后端分别独立开发，前端与后端通信的方式多为使用 Ajax 发送 HTTP 请求。然而，由于浏览器的安全策略限制，可能会出现跨域问题，导致请求失败。本文将从以下几个方面进行总结：

什么是跨域问题？
为什么会出现跨域问题？
什么情况下会出现跨域？
如何解决跨域问题？
代码示例

二、什么是跨域问题

跨域问题指的是在 Web 应用程序中，由于同源策略的限制，导致浏览器无法发送跨域请求，也无法获取跨域响应的问题。同源策略是浏览器的一种安全策略，它要求 Web 应用程序只能访问与当前页面具有相同协议、主机名和端口号的资源。

如果不同源的 Web 应用程序需要通信，就需要进行跨域请求。但由于同源策略的限制，浏览器不允许跨域请求。在此情况下，如果前端需要访问其他域名下的资源，就会出现跨域问题。

三、为什么会出现跨域问题

出现跨域问题的主要原因是同源策略的限制。同源策略是浏览器的一种安全策略，它要求 Web 应用程序只能访问与当前页面具有相同协议、主机名和端口号的资源。

如果 Web 应用程序需要访问不同源的资源，就需要进行跨域请求。但由于同源策略的限制，浏览器不允许跨域请求。这是因为跨域请求可能会导致一些安全问题，例如 CSRF（跨站请求伪造）攻击。

四、什么情况下会出现跨域

在 Web 应用程序中，以下情况可能会导致跨域问题：

域名不同：例如，当前页面的域名为 www.example.com，而请求的资源的域名为 api.example.com。

协议不同：例如，当前页面的协议为 https，而请求的资源的协议为 http。

端口号不同：例如，当前页面的端口号为 8080，而请求的资源的端口号为 9090。

五、如何解决跨域问题

本文将详细介绍在SpringBoot中如何解决跨域问题：

5.1 使用@CrossOrigin注解

在SpringBoot的Controller层中可以通过@CrossOrigin注解来实现跨域访问控制，只需要在方法上添加该注解即可。

@RestController
@RequestMapping("/user")
public class UserController {
    @GetMapping("/{id}")
    @CrossOrigin(origins = "http://localhost:8080")
    public User getUser(@PathVariable Long id) {
        return userService.getUser(id);
    }
}

@CrossOrigin注解中的origins属性表示允许跨域请求的源地址，多个地址可以用逗号分隔。如果不指定该属性，则表示允许所有来源的请求。

需要注意的是，@CrossOrigin注解只适用于控制器方法，而不适用于控制器类。如果需要在整个控制器类中启用跨域访问控制，则可以在控制器类上添加@CrossOrigin注解，并设置对应的属性值。

5.2 使用WebMvcConfigurer

除了@CrossOrigin注解外，还可以通过实现WebMvcConfigurer接口来配置跨域访问控制。

@Configuration
public class CorsConfig implements WebMvcConfigurer {
    @Override
    public void addCorsMappings(CorsRegistry registry) {
        registry.addMapping("/user/**")
                .allowedOrigins("http://localhost:8080")
                .allowedMethods("GET", "POST", "PUT", "DELETE")
                .allowCredentials(true)
                .maxAge(3600);
    }
}

上述代码中，我们创建了一个名为CorsConfig的配置类，并实现了WebMvcConfigurer接口。在addCorsMappings()方法中，我们定义了允许跨域访问的映射路径、允许访问的来源、允许访问的HTTP方法、是否允许发送Cookie和响应的缓存时间等信息。

5.3 使用Filter

还可以通过自定义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", "http://localhost:8080");
        response.setHeader("Access-Control-Allow-Methods", "GET, POST, PUT, DELETE");
        response.setHeader("Access-Control-Allow-Credentials", "true");
        response.setHeader("Access-Control-Max-Age", "3600");
        chain.doFilter(req, res);
    }
}

上述代码中，在上述代码中，我们设置了Access-Control-Allow-Origin、Access-Control-Allow-Methods、Access-Control-Max-Age以及Access-Control-Allow-Headers等响应头信息。其中Access-Control-Allow-Origin设置为"*"表示允许所有来源进行访问，Access-Control-Allow-Methods指定了支持的HTTP请求方法，Access-Control-Max-Age设置预检请求的有效期时间，Access-Control-Allow-Headers设置了允许携带的请求头。

六、代码示例

前端代码

为了演示跨域请求的处理，我们可以使用前端技术来发送一个跨域请求，例如使用JavaScript中的XMLHttpRequest对象。下面是一个简单的HTML页面，用来演示如何发送跨域请求：

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>跨域请求示例</title>
</head>
<body>
    <button onclick="sendRequest()">发送请求</button>
    <div id="result"></div>
    <script>
        function sendRequest() {
            var xhr = new XMLHttpRequest();
            xhr.open('GET', 'http://localhost:8080/api/hello', true);
            xhr.onreadystatechange = function() {
                if (xhr.readyState == 4 && xhr.status == 200) {
                    document.getElementById('result').innerText = xhr.responseText;
                }
            };
            xhr.send();
        }
    </script>
</body>
</html>

在这个HTML页面中，我们定义了一个按钮和一个用于显示请求结果的div元素。当用户点击按钮时，将会发送一个跨域请求到我们在SpringBoot中定义的/api/hello路径。

后端后端

@RestController
@RequestMapping("/api")
public class ApiController {
    @GetMapping("/hello")
    public String sayHello() {
        return "Hello, World!";
    }
}

在上面的示例中，我们定义了一个名为ApiController的控制器类，并在其中定义了一个名为sayHello()的GET请求处理方法。这个方法将返回一个简单的字符串消息。快使用本文中介绍的三种解决跨域的方式实现一下吧。