快捷導(dǎo)航

SpringSecurity?跨域資源共享(CORS)的實現(xiàn)

更新時間：2025年09月12日 10:43:46 作者：wx6875a567c49bb

本文主要介紹了SpringSecurity?跨域資源共享,文中通過示例代碼介紹的非常詳細(xì),對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧

瀏覽器的同源策略（Same-Origin Policy, SOP）是瀏覽器最核心、最基礎(chǔ)的安全機(jī)制之一，本質(zhì)是為了隔離不同域名的資源，防止惡意網(wǎng)站竊取或篡改其他網(wǎng)站的敏感數(shù)據(jù)，保障用戶隱私和網(wǎng)絡(luò)安全。“同源” 指的是兩個資源的 “協(xié)議（Protocol）、域名（Domain）、端口（Port）” 三者完全一致，缺一不可。只要任意一項不同，就屬于 “跨源（Cross-Origin）”。

CORS（Cross-Origin Resource Sharing）即跨域資源共享，應(yīng)用程序會通過 CORS（跨域資源共享）機(jī)制來放寬這一嚴(yán)格的（同源）策略，從而允許在特定條件下進(jìn)行跨源請求。在當(dāng)前流行的前后端分離架構(gòu)模式下很可能會用到 CORS。

創(chuàng)建一個頁面 src\main\resources\static\index.html，這是一個靜態(tài)文件，可以直接被訪問，頁面的訪問地址是 http://localhost/index.html，頁面中有一個按鈕，點擊按鈕的時候使用 fetch 發(fā)起對 http://localhost/hello 的請求。

<!DOCTYPE html>
<html lang="en">

<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>Document</title>
</head>

<body>
  <button id="getHelloBtn">get hello</button>

  <script>
    const getHelloBtn = document.getElementById('getHelloBtn');
    getHelloBtn.addEventListener('click', () => {
      fetch('http://127.0.0.1/hello')
        .then(res => res.text())
        .then(data => {
          console.log(data);
        })
    })
  </script>
</body>

</html>

因為頁面使用的域名是 localhost 和接口使用的是 127.0.0.1 IP 地址，域名不一致，所以請求的響應(yīng)被阻止了。

此時可以通過配置 CORS 就可以來解決這個同源策略的限制。Spring 提供了 @CrossOrigin 注解，把這個注解加在控制器上：

@RestController
public class HelloController {

  @RequestMapping(value = { "/hello" }, method = RequestMethod.GET)
  // 允許 http://localhost 域發(fā)起對該接口的請求
  @CrossOrigin("http://localhost")
  public String requestMethodName() {
    return "Hello, Spring!";
  }
}

再次點擊按鈕，瀏覽器控制臺中打印出了接口響應(yīng)的內(nèi)容：

@CrossOrigin 除了可以用在方法上之外，還可以用在類上，這樣整個控制器就都允許跨域訪問了。@CrossOrigin 還提供了其他配置參數(shù)

public @interface CrossOrigin {
   @AliasFor("origins")
   String[] value() default {};	// 允許跨域請求的源

   @AliasFor("value")
   String[] origins() default {}; // 允許跨域請求的源

   String[] originPatterns() default {}; // 通過通配符模式匹配允許的來源

   String[] allowedHeaders() default {}; // 指定跨域請求中允許攜帶的請求頭

   String[] exposedHeaders() default {}; // 指定跨域響應(yīng)中允許前端讀取的響應(yīng)頭

   RequestMethod[] methods() default {}; // 指定允許的 HTTP 請求方法

   String allowCredentials() default ""; // 指定是否允許跨域請求攜帶身份憑證，
   								// 若設(shè)為 true，origins 不能為 *（必須指定具體來源），否則瀏覽器會拒絕響應(yīng)。

   String allowPrivateNetwork() default ""; // 控制是否允許來自私有網(wǎng)絡(luò)（如局域網(wǎng)）的跨域請求

   long maxAge() default -1L; // 指定預(yù)檢請求（Preflight Request）的結(jié)果緩存時間（單位：秒）
}

通過 @CrossOrigin 注解可以很簡單地解決跨域問題，但需要每個控制器都要配置一次，就顯得比較啰嗦了，而且一旦需要修改配置工作量就比較大，而且還可能產(chǎn)生一些風(fēng)險。

Spring Security 也提供了 CORS 的配置，可以進(jìn)行全局的配置：

@Configuration
public class SecurityConfig {

  @Resource
  private CustomAuthenticationProvider customAuthenticationProvider;

  @Bean
  SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {

    http
        .authenticationProvider(customAuthenticationProvider)
        .httpBasic(Customizer.withDefaults());

    http.csrf(c -> c.disable());

    http.cors(c -> {
      CorsConfigurationSource source = request -> {
        CorsConfiguration config = new CorsConfiguration();
        config.setAllowedOrigins(Arrays.asList("http://localhost")); // 允許跨域請求的源
        config.setAllowedMethods(Arrays.asList("GET", "POST"));	// 指定允許的 HTTP 請求方法
        config.setAllowedHeaders(Arrays.asList("*")); // 指定跨域響應(yīng)中允許前端讀取的響應(yīng)頭
        return config;
      };
      c.configurationSource(source);
    });

    http.authorizeHttpRequests(
        auth -> auth
            .anyRequest().permitAll());
    return http.build();
  }

}

如果需要不同的路徑有不同的跨域配置，也沒問題：

@Configuration
public class SecurityConfig {

  @Resource
  private CustomAuthenticationProvider customAuthenticationProvider;

  @Bean
  SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {

    http
        .authenticationProvider(customAuthenticationProvider)
        .httpBasic(Customizer.withDefaults());

    http.csrf(c -> c.disable());

    http.cors(c -> {
      UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();

      CorsConfiguration config = new CorsConfiguration();
      config.setAllowedOrigins(Arrays.asList("http://localhost"));
      config.setAllowedMethods(Arrays.asList("GET"));
      config.setAllowedHeaders(Arrays.asList("*"));
      source.registerCorsConfiguration("/hello", config); // 給指定的路徑綁定 CORS 配置

      CorsConfiguration config2 = new CorsConfiguration();
      config2.setAllowedOrigins(Arrays.asList("http://localhost"));
      config2.setAllowedMethods(Arrays.asList("POST"));
      config2.setAllowedHeaders(Arrays.asList("*"));
      source.registerCorsConfiguration("/aa/bb/cc", config2); // 給指定的路徑綁定 CORS 配置
      
      c.configurationSource(source);
    });

    http.authorizeHttpRequests(
        auth -> auth
            .anyRequest().permitAll());
    return http.build();
  }

}

到此這篇關(guān)于SpringSecurity 跨域資源共享(CORS)的文章就介紹到這了,更多相關(guān)SpringSecurity 跨域資源共享內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: