【技术沙箱|Springboot依赖|spring-boot-starter-web】2、Cors 全局跨域配置

CORS 不是接口鉴权,也不是“允许哪个项目调用”的通用开关。

它是浏览器的安全机制:浏览器发现当前页面源和请求接口源不同,就检查后端有没有返回 CORS 放行头。

CORS 是给“浏览器”看的跨域放行规则,不是给“别的项目”看的调用许可。
只有浏览器里跨源请求你的接口时,才用得上全局 CORS 配置。

比如:

  • 别的“前端项目”在浏览器里调你接口:可能要 CORS。

  • 别的“后端项目”调你接口:不需要 CORS,可能需要 token、签名、IP 白名单、网关鉴权。

  • 你自己项目前后端分离,前端域名/端口不同:要 CORS 或代理。

  • 生产环境用 Nginx 把前端和接口放同一个域名下:通常就不需要 CORS。

@Configuration
public class CorsConfig implements WebMvcConfigurer {

@Override
public void addCorsMappings(CorsRegistry registry) {
registry.addMapping("/**")
// 允许来源,* 代表全部,生产要改成前端域名
.allowedOrigins("*")
// 允许的请求方式
.allowedMethods("GET","POST","PUT","DELETE","OPTIONS")
.allowedHeaders("*")
// 是否允许携带cookie(如果origins是*,这个不能开true)
.allowCredentials(false)
.maxAge(3600);
}
}
  • /**:所有接口都生效

  • allowedOrigins:允许哪些前端地址

  • allowedMethods:允许哪些请求方法

  • allowedHeaders:允许携带哪些请求头

  • allowCredentials:是否允许带 Cookie

  • maxAge:预检请求结果缓存多久

allowedOriginPatterns 和 allowedOrigins 是一样的吗?(不是)

1. allowedOrigins(老版本)

作用:配置允许的来源地址

  • 写法:allowedOrigins("http://localhost:8080", "https://xxx.com")
  • 限制:如果写 allowedOrigins("*"),就不能开启 allowCredentials(true)(允许携带 cookie),浏览器会直接拦截,启动或者运行时报错
  • 只能写精确地址,不支持通配符匹配域名,比如 *.xxx.com 这种写法不生效

2. allowedOriginPatterns(SpringBoot 2.4+ 新增,推荐现在用)

作用:允许通配符模式匹配

  • 支持 *,也支持 https://*.xxx.com
  • ✅ 可以和 allowCredentials(true) 同时开启,不会报错
  • 就是专门替代 allowedOrigins("*") 的方案
posted @ 2026-11-14 09:44  椿树之久  阅读(5)  评论(0)    收藏  举报