哈哈，今天咱们聊个让前后端工程师头疼的事儿——Spring Boot 配置全局跨域。说真的，我记得刚接触这个的时候，那叫一个麻烦啊！总是报错，不是前端没搞定就是后端配置不对。后来经过无数次摸爬滚打，终于出了一套稳定的方案。今天就来分享一下省得大家再踩这些坑了。

为什么要配置全局跨域？

咱们得明白，为什么要配置全局跨域？那个那个...简单来说就是因为浏览器有个同源策略限制。什么意思呢？就是Ru果你的前端和后端不在一个域名下面比如前端是 http://localhost:8080，后端是 http://localhost:9090，那么浏览器就会拦截请求。这叫"跨域请求"。

你说为啥要用不同的域名呢？不对不对，应该是说为啥要用不同的端口号或者协议？其实原因hen简单啊：

前后端分离开发：前端用 Vue/React/Angular 这些框架独立运行

不同环境部署：开发环境、测试环境、生产环境各有各的规则

安全隔离：把静态资源和接口服务分开部署

所以呢，跨域不是 bug，而是浏览器为了安全设计的机制。我们需要Zuo的是合法地绕过这个限制。

跳进坑里——常见错误方案

一开始我也尝试过hen多种方法来解决这个问题：

直接在 Controller 上加注解@CrossOrigin

哎呦喂！每个接口dou加？那得累死！

改动太大了还容易漏掉某些接口

修改 Nginx 配置通过反向代理

这东西适合生产环境倒是挺好

但是开发阶段还要搭建 Nginx？麻烦死了吧！

随便放行所有域名allowedOrigins

Zui懒人方案

但是生产环境这么干绝对不行啊！

这些方法kan似Neng解决问题短期内kan起来没毛病，但长期来kan会带来geng多麻烦。比如线上突然出现莫名其妙的安全问题什么的...害！

Zui佳实践——WebMvcConfigurer 全局配置

经过一番折腾之后我发现Zui可靠的还是 WebMvcConfigurer 接口提供的全局配置方式。这个方案优点多多：

集中管理所有跨域规则

不需要改动任何 Controller 接口

兼容 Spring Boot 各个版本

支持复杂场景

具体怎么搞呢？kan我这边示例代码：

java @Configuration public class CorsConfig implements WebMvcConfigurer {

@Override
public void addCorsMappings {
    registry.addMapping
            .allowedOriginPatterns
            .allowedMethods
            .allowedHeaders
            .allowCredentials
            .maxAge;
}

}

让我给你解释一下这个配置里面每个参数是什么意思：

addMapping对所有路径dou应用这个规则

allowedOriginPatterns

本地开发支持所有本地端口

生产环境使用你实际部署时的主机名或IP范围

allowedMethods

必须包含 OPTIONS！这是预检请求专用方法！

allowCredentials

开启凭证传递支持

maxAge

预检请求缓存时间为1小时

特别注意那个 allowedOriginPatterns 用法！Spring Boot 新版本Yi经废弃了 allowedOrigins方法哦！必须使用 allowedOriginPatterns才Neng正确支持通配符匹配。

高级玩法——SpringSecurity 项目特殊处理

Ru果你正在使用 SpringSecurity 框架的话...那可就geng复杂一点了！因为 Security 的权限控制会干扰我们之前设置好的跨域规则。

遇到这种情况就需要单独处理一下啦~

java @Configuration public class SecurityCorsConfig {

@Bean
public CorsFilter corsFilter {
    UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource;
    CorsConfiguration config = new CorsConfiguration;
    config.setAllowedOriginPatterns(Arrays.asList(
        "http://localhost:*",
        "http://.*yourdomain.com:*"
    ));
    config.setAllowedMethods(Arrays.asList(
        "GET", "POST", "PUT", "DELETE", "OPTIONS"
    ));
    config.setAllowedHeaders);
    config.setAllowCredentials;
    config.setMaxAge;
    source.registerCorsConfiguration;
    return new CorsFilter;
}
// 其他 Security 配置...

}

这里关键在于直接注册了一个 CorsFilter 跨域过滤器来强制覆盖默认行为。这样即使 Security 拦截也不会影响我们设定好的规则啦！

前后端联调高频问题汇总

在实际项目中经常会遇到一些奇怪问题让人抓狂不Yi啊...现在统统给你们罗列出来！

啊哈！普通 GET/POST 没问题但 PUT/DELETE 报错？

原因hen简单——忘记放行 OPTIONS 方法啦！

解决方案：一定要确保 allowedMethods 包含 OPTIONS！

携带 Token 的请求总是失败？

这是因为没有正确设置 allowCredentials 和允许自定义请求头啊～

记得这样写： java .configsetAllowCredentials .configsetAllowedHeaders)

本地联调完全没问题但线上却报错？

典型表现就是允许凭证+通配符同时存在时会被拒绝～

新版 Spring Boot 对安全要求geng高啦！所以必须改成像这样明确指定允许哪些具体来源而不是简单 *号通配符：

java .configsetAllowedOriginPatterns( ArraysasList( "https//api.example.com", null // null表示与服务器相同协议和主机但可Neng不同路径或子目录等情况下仍然接受该来源访问资源时所需值之类内容等等。 )

某些接口偶尔报错而其他正常？

通常是由于不同地方混合使用了各种方式导致优先级冲突～比如同时存在 @CrossOrigin 注解和全局WebMvcConfigurer...

建议：彻底删除所有 @CrossOrigin 注解只保留统一全局管理方案～少出差错geng稳健哦～

跨越终极坑洞——为什么百度不收录？

哦对了说起网站被百度收录...这也是一个经常困扰人的老生常谈话题嘛～hen多时候网站Zuo好了却发现搜索引擎根本找不到自己...

主要几个可Neng原因有这些：

1️⃣ 内容质量太低或重复性太高 2️⃣ 未正确填写 sitemap.xml 或 robots.txt 指令文件告知爬虫哪些页面可访问以及其重要程度等信息以便于其按照优先级顺序抓取并索引站点中具有代表性意义且较为关键部分之类内容等等。 3️⃣ 未提交站点给搜索引擎进行验证并申请收录入库备查之类操作等等。 4️⃣ 外链质量太差或者数量不足导致权重积累受阻无法被识别推荐给用户结果集返回展示显示位列首位排序靠前排名较高之类效果达到目的意图达成Zui终目标实现愿望满足需求满足要求达到预期效果达到预期目标达成预期结果完成任务成功完成项目顺利完成工作圆满结束任务圆满结业毕业走入社会步入职场进入社会参加工作投身实践迈向新阶段进入新时代展开崭新篇章开始美好生活迎接美好未来书写人生华章创造辉煌业绩取得骄人成绩获得丰硕成果赢得荣誉称号获得奖项奖励夺取冠军宝座夺取第一名夺得Zui高分获取Zui大回报得到Zui佳体验享受至高荣耀感受无限快乐感受幸福生活感受美好时光感受精彩瞬间感受激动人心感受振奋人心感受鼓舞人心...

关于 SEO 排名方面还有hen多技巧值得探讨不过今天主要聊的是技术层面实现手段~想了解geng多 SEO 技巧Ke以私聊我吖~毕竟技术只是手段而商业价值才是目的嘛~嘿嘿~

---