快捷導(dǎo)航

springboot項(xiàng)目實(shí)現(xiàn)配置跨域

更新時(shí)間：2024年09月05日 08:59:05 作者：wangpeng1201

這篇文章主要介紹了springboot項(xiàng)目實(shí)現(xiàn)配置跨域問(wèn)題,具有很好的參考價(jià)值,希望對(duì)大家有所幫助,如有錯(cuò)誤或未考慮完全的地方,望不吝賜教

1. 使用@CrossOrigin注解

最簡(jiǎn)單的方式是在控制器或者具體的方法上使用@CrossOrigin注解。

例如：

import org.springframework.web.bind.annotation.CrossOrigin;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@CrossOrigin(origins = "http://example.com") // 允許來(lái)自 http://example.com 的跨域請(qǐng)求
public class MyController {

    @GetMapping("/myEndpoint")
    public String myMethod() {
        return "Hello, World!";
    }
}

這將允許來(lái)自http://example.com的跨域請(qǐng)求訪問(wèn)/myEndpoint這個(gè)接口。

2. 全局跨域配置

如果你想要為整個(gè)應(yīng)用配置跨域支持，可以在配置類中添加一個(gè)WebMvcConfigurer的實(shí)現(xiàn)：

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 WebConfig implements WebMvcConfigurer {

    @Override
    public void addCorsMappings(CorsRegistry registry) {
        registry.addMapping("/**") // 為所有請(qǐng)求添加跨域支持
                .allowedOrigins("*")    // 允許任何源
                .allowedMethods("GET", "POST", "PUT", "DELETE") // 允許的HTTP方法
                .allowCredentials(true); // 是否允許發(fā)送Cookie信息
    }
}

這個(gè)配置將允許任何源的跨域請(qǐng)求，并且允許GET、POST、PUT和DELETE方法。

allowCredentials設(shè)置為true表示允許客戶端發(fā)送Cookie信息。

3. 使用CorsFilter

如果需要更細(xì)致的控制，可以創(chuàng)建一個(gè)CorsFilter并注冊(cè)為Bean：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.cors.CorsConfiguration;
import org.springframework.web.cors.CorsConfigurationSource;
import org.springframework.web.cors.UrlBasedCorsConfigurationSource;
import org.springframework.web.filter.CorsFilter;

@Configuration
public class CorsConfig {

    @Bean
    public CorsFilter corsFilter() {
        CorsConfiguration configuration = new CorsConfiguration();
        configuration.setAllowedOrigins("*");
        configuration.setAllowedMethods("GET", "POST", "PUT", "DELETE");
        configuration.setAllowCredentials(true);
        configuration.setAllowedHeaders("*");

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

這個(gè)配置與上面的全局跨域配置類似，但是通過(guò)CorsFilter提供了更多的靈活性和控制。

注意事項(xiàng)：

allowedOrigins可以是一個(gè)具體的域名，如"http://example.com"，或者使用"*"來(lái)允許任何源。
allowedMethods定義了允許的HTTP方法。
allowCredentials設(shè)置為true時(shí)，服務(wù)器將接受包含敏感信息（如Cookies和HTTP認(rèn)證信息）的跨域請(qǐng)求。
allowedHeaders定義了允許的HTTP請(qǐng)求頭。

根據(jù)你的項(xiàng)目需求和安全考慮，合理配置跨域支持是非常重要的。

在生產(chǎn)環(huán)境中，通常不建議允許任何源（"*"），而是應(yīng)該明確指定可信的源。

當(dāng)然，除了上述提到的使用@CrossOrigin注解、全局跨域配置和CorsFilter之外，還有其他一些方法可以在Spring Boot項(xiàng)目中配置跨域支持。

4. 配置WebMvcConfigurerProperties

在Spring Boot中，可以通過(guò)擴(kuò)展WebMvcConfigurerProperties類來(lái)配置跨域。

首先，需要?jiǎng)?chuàng)建一個(gè)配置類并繼承WebMvcConfigurerProperties：

import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

@Configuration
@ConfigurationProperties(prefix = "cors")
public class CorsConfig implements WebMvcConfigurer {

    private String[] allowedOrigins;
    private String[] allowedMethods;
    private String[] allowedHeaders;
    private boolean allowCredentials;

    // getters and setters ...

    @Override
    public void addCorsMappings(CorsRegistry registry) {
        registry.addMapping("/**")
                .allowedOrigins(allowedOrigins)
                .allowedMethods(allowedMethods)
                .allowedHeaders(allowedHeaders)
                .allowCredentials(allowCredentials);
    }
}

然后，在application.properties或application.yml中添加相應(yīng)的配置：

# application.properties
cors.allowedOrigins[0]=http://example.com
cors.allowedMethods[0]=GET
cors.allowedMethods[1]=POST
cors.allowedHeaders[0]=Content-Type
cors.allowCredentials=true

5. 使用Spring Security

如果你的項(xiàng)目中使用了Spring Security，可以通過(guò)配置HttpSecurity來(lái)實(shí)現(xiàn)跨域支持。

首先，需要?jiǎng)?chuàng)建一個(gè)配置類并重寫configure(HttpSecurity http)方法：

import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter;

@Configuration
public class SecurityConfig extends WebSecurityConfigurerAdapter {

    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http
            // ...其他配置...
            .cors().and() // 啟用默認(rèn)的跨域配置
            // ...其他配置...
    }
}

如果需要自定義跨域配置，可以使用.cors()方法并傳遞一個(gè)CorsConfigurationSource實(shí)例：

 CorsConfiguration configuration = new CorsConfiguration();
 configuration.setAllowedOrigins(Arrays.asList("http://example.com"));
 configuration.setAllowedMethods(Arrays.asList("GET","POST", "PUT", "DELETE"));
 configuration.setAllowedHeaders(Arrays.asList("Content-Type", "Authorization"));
 configuration.setAllowCredentials(true);

 UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
 source.registerCorsConfiguration("/**", configuration);

 http.cors(source).and();