当前位置：首页 > news >正文

Spring Boot 中如何解决 CORS 问题（详解）

news 来源：原创 2025/8/14 4:43:44

在前后端分离的开发模式中，前端调用后端接口时，经常会遇到跨域资源共享（CORS）的问题。Spring Boot 作为常用的后端框架，提供了多种方式来优雅地解决这个问题。本文将全面介绍 Spring Boot 中处理 CORS 的常见方法、原理分析及注意事项，帮助开发者高效排查和解决跨域问题。

一、什么是 CORS？

CORS（Cross-Origin Resource Sharing，跨域资源共享）是浏览器的一种安全策略，用于防止页面被恶意地从一个域加载资源到另一个域。简单来说，只要前端请求的协议、域名、端口与后端接口不完全一致，就属于跨域请求。

例如：

前端地址：http://localhost:3000
后端接口：http://localhost:8080/api/data

这就构成了跨域请求，浏览器会默认拦截这类请求，除非服务器端明确允许跨域访问。

二、Spring Boot 中解决 CORS 的几种方法

Spring Boot 提供了多种方式来配置和处理跨域问题，以下是最常用的三种方法：

方法一：使用 `@CrossOrigin` 注解（推荐用于小型项目或测试）

这是 Spring Boot 提供的快捷方式，可直接作用于控制器类或方法上：

@RestController
@RequestMapping("/api")
@CrossOrigin(origins = "http://localhost:3000")
public class MyController {@GetMapping("/data")public String getData() {return "Hello, CORS!";}
}

参数说明：

origins：允许的域名（可为 * 表示所有）。
methods：允许的方法，如 GET, POST 等。
maxAge：预检请求的有效时间（单位秒）。
allowedHeaders：允许携带的头信息。

缺点：对于中大型项目来说，控制器众多，维护成本高。

方法二：全局 CORS 配置（推荐用于中大型项目）

通过实现 WebMvcConfigurer 接口，全局统一配置跨域规则，适用于大多数项目场景。

@Configuration
public class CorsConfig implements WebMvcConfigurer {@Overridepublic void addCorsMappings(CorsRegistry registry) {registry.addMapping("/**") // 所有接口.allowedOrigins("http://localhost:3000") // 允许的前端地址.allowedMethods("GET", "POST", "PUT", "DELETE") // 允许的方法.allowedHeaders("*") // 允许的请求头.allowCredentials(true) // 允许携带 Cookie.maxAge(3600); // 预检请求缓存时间（秒）}
}

优点：配置集中，维护简单，推荐使用。

方法三：通过 Filter 手动设置响应头（不推荐，除非特殊需求）

手动注册一个过滤器，向响应中添加 CORS 相关头信息：

@Component
public class CorsFilter implements Filter {@Overridepublic void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)throws IOException, ServletException {HttpServletResponse res = (HttpServletResponse) response;HttpServletRequest req = (HttpServletRequest) request;res.setHeader("Access-Control-Allow-Origin", "http://localhost:3000");res.setHeader("Access-Control-Allow-Methods", "GET,POST,PUT,DELETE,OPTIONS");res.setHeader("Access-Control-Allow-Headers", "*");res.setHeader("Access-Control-Allow-Credentials", "true");// OPTIONS 预检请求直接返回if ("OPTIONS".equalsIgnoreCase(req.getMethod())) {res.setStatus(HttpServletResponse.SC_OK);} else {chain.doFilter(request, response);}}
}

缺点：易出错，不易维护，建议使用 WebMvcConfigurer 方式代替。

三、常见问题排查

OPTIONS 请求返回 403 或没有响应？
- 确保后端允许 OPTIONS 方法。
- 确保没有被 Spring Security 拦截。
携带 Cookie 不生效？
- 后端必须设置：.allowCredentials(true)
- 前端必须设置：axios.defaults.withCredentials = true
Spring Security 拦截 CORS 请求？
- 需要额外配置 CORS 策略，示例如下：

@EnableWebSecurity
public class SecurityConfig {@Beanpublic SecurityFilterChain filterChain(HttpSecurity http) throws Exception {http.cors() // 启用 CORS.and().csrf().disable().authorizeHttpRequests().anyRequest().permitAll();return http.build();}@Beanpublic CorsConfigurationSource corsConfigurationSource() {CorsConfiguration config = new CorsConfiguration();config.setAllowedOrigins(List.of("http://localhost:3000"));config.setAllowedMethods(List.of("GET", "POST", "PUT", "DELETE", "OPTIONS"));config.setAllowedHeaders(List.of("*"));config.setAllowCredentials(true);UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();source.registerCorsConfiguration("/**", config);return source;}
}

四、总结

方法	场景	推荐度
`@CrossOrigin` 注解	控制器少，接口固定	⭐⭐
实现 `WebMvcConfigurer`	中大型项目，统一配置	⭐⭐⭐⭐⭐
自定义 Filter	特殊需求（如动态域）	⭐

CORS 配置看似简单，但与前端请求设置、Spring Security 配合使用时需格外注意。建议在项目初始化阶段就进行统一的跨域策略设计，避免后续频繁调整。

五、参考文档

MDN - CORS 简介
Spring 官方文档 - Enabling CORS

Spring Boot 中如何解决 CORS 问题（详解）

在前后端分离的开发模式中，前端调用后端接口时，经常会遇到跨域资源共享（CORS） 的问题。Spring Boot 作为常用的后端框架，提供了多种方式来优雅地解决这个问题。本文将全面介绍 Spring Boot 中处理 CORS 的常见方法、原…...

编程日记 2025/8/14 4:43:44

深度学习：智能车牌识别系统（python）

这是一个基于opencv的智能车牌识别系统，有GUI界面。程序能自动识别图片中的车牌号码，并支持中文和英文字符识别，支持选择本地图片文件，支持多种图片格式（jpg、jpeg、png、bmp、gif）。下面，我将按模块功能对代码进行分段说明： 1. 导入模块部分 import tkinter as tk…...

编程日记 2025/8/11 16:14:56

STM32开发printf函数支持

1、printf函数支持 1、避免使用半主机模式：两种方法:微库法、代码法 2、实现fputc函数：实现单个字符输出 2、半主机模式简介用于 ARM 目标的一种机制，可将来自应用程序代码的输入/输出请求传送至运行调试器的主机简单说:就是通过仿真器实…...

编程日记 2025/8/14 4:35:58

解决 Chrome 与 Chromedriver 版本不一致问题的方法

目录常见错误处理处理方案： 1. 自动版本匹配方法使用 webdriver-manager 库（推荐） 2. 手动版本管理方法检查并匹配版本 3. 版本兼容性解决方案使用兼容性表 4. 自动更新策略定期检查更新脚本 5. Docker 容器化方案最佳实践建…...

编程日记 2025/8/11 20:52:23

CPU的基本认识

为大家介绍CPU的基本概念，例如：CPU的型号认识、什么是时钟周期、物理核和逻辑核、缓存、TLB缓存的概念，可以帮助大家对cpu有个概念性的认识，选择电脑的时候可以看懂CPU的参数和理解基本原理。 CPU的基本认识个人CPU型号介绍工作频…...

编程日记 2025/8/14 4:41:59

UGUI如何使用EventTrigger

前言在 Unity 的 UGUI 系统中，EventTrigger 是一个强大的组件，允许开发者监听和处理多种 UI 交互事件。以下是详细的使用方法、示例代码、优缺点分析以及注意事项。一、EventTrigger 基本用法 1. 添加 EventTrigger 组件在 Unity 编辑器中选中 UI 对象（如 But…...

编程日记 2025/8/11 10:23:16

101alpha_第4个

(-1 * ts_rank(rank(low), 9)) 这里的low是每日的最低价。各函数及整体含义解释 1. rank(low) 在金融分析场景里，low 通常代表股票在每个交易日中的最低价。rank(low) 会对一段时间内的最低价数据进行排序，并为每个数据赋予一个排名。比如，…...

编程日记 2025/8/14 4:40:38

5月13日观测云发布会：这一次，我们不只是发布产品

01｜为什么举办这场发布会？ 在生成式 AI 席卷一切、业务系统愈发复杂的时代，我们发现： 传统的监控观测已经无法满足企业对性能、安全、智能的统一诉求；每一个企业，都在经历从“看得到”到“看得懂”的跃迁&…...

编程日记 2025/8/14 4:38:25

【IP101】图像分割技术全解析：从传统算法到深度学习的进阶之路

图像分割详解 ✂️ 欢迎来到图像处理的"手术室"！在这里，我们将学习如何像外科医生一样精准地"切割"图像。让我们一起探索这个神奇的图像"手术"世界吧！🏥 目录 📑 1. 图像分割简介2. 阈…...

编程日记 2025/8/13 20:38:23

华为设备链路聚合实验：网络工程实战指南

链路聚合就像为网络搭建 “并行高速路”，既能扩容带宽，又能保障链路冗余，超实用！ 一、实验拓扑速览图中两台交换机 LSW1 和 LSW2，PC1、PC2 归属 VLAN 10，PC3 归属 VLAN 30。LSW1 与 LSW2 通过 GE0/0/1、…...

编程日记 2025/6/29 3:37:30

C24-数组

数组的引入:方便对同一类型的数据进行管理(一个班级里的45个同学、一个篮子里的12个苹果)数组的定义: 数据类型数组名[常量表达式(也就是元素的个数)];int a[10]; //这里定义了一个能存放10个元素的整形数组数组初始化完全初始化 int arr[3]{5,6,8};部分初始化 int arr[10]{…...

编程日记 2025/8/14 4:38:25

Vue 项目中长按保存图片功能实现指南

在移动互联网应用中，用户常常有保存页面特定内容为图片的需求，比如保存二维码、海报等。在 Vue 项目开发中，如何实现长按保存图片的功能？本文将结合具体代码，详细讲解在 Vue 项目中通过长按操作保存图片的技术实现与应…...

编程日记 2025/8/14 4:40:37

行业先锋：六款产品的实战表现

行业先锋：六款产品的实战表现　　北京先智先行科技有限公司，销售着“先知大模型”、“先行AI商学院”“先知AIGC超级工场”这三个旗舰产品，在行业内崭露头角。旗下的先知A1、先知大模型等更是备受关注。　　先知大模型，作为核心产…...

编程日记 2025/8/14 4:40:56

RS485与Profibus网关自由口数据互换技巧

RS485与Profibus网关自由口数据互换技巧兴达易控RS485转Profibus网关在自由口模式下的数据互换，是工业自动化领域内一项关键的技术应用，它实现了不同通信协议设备之间的有效连接与数据交换。在现代工业生产中，众多设备和系统往往采用不同的…...

编程日记 2025/8/14 4:42:20

java复杂度，包装类，泛型解析

如何衡量代码的好坏？ 评价代码的好坏我们使用算法效率来判断，而算法效率分两种： 算法效率： 第一种是时间效率，第二种是空间效率，时间效率被称为时间复杂度，⽽空间效率被称作空间复杂度。时间…...

编程日记 2025/8/14 4:37:43

K8S安装部署（v1.27.6）

一、机器配置系统版本主机名IP基于服务centos 7.9k8s-master192.168.163.104dockerk8s-node1192.168.163.105k8s-node2192.168.163.106注：以上3台机器都是2C4G的虚拟机，仅供测试使用 docker部署可以参考：docker 部署二、其他环境配置 #1、关闭防火墙 systemctl stop fir…...

编程日记 2025/6/29 5:00:57

Debezium BinaryLogClient详解

Debezium BinaryLogClient详解 1. 类的作用与功能 1.1 核心作用 BinaryLogClient是Debezium中负责与MySQL服务器建立和维护Binlog连接的核心类，主要功能包括：连接管理：建立和维护与MySQL服务器的Binlog连接事件监听：接收和处理Binlog事件心跳保活：维护连接活跃状态断线…...

编程日记 2025/8/14 4:35:55

Leetcode 刷题记录 09 —— 链表第三弹

本系列为笔者的 Leetcode 刷题记录，顺序为 Hot 100 题官方顺序，根据标签命名，记录笔者总结的做题思路，附部分代码解释和疑问解答，01~07为C语言，08及以后为Java语言。 01 合并 K 个升序链表 /*** Definitio…...

编程日记 2025/8/14 4:42:02

加速项目落地（Trae编辑器）

目录 vscode安装python支持 vscode常用插件 Trae编辑器两个界面合成补充（QT开发的繁琐） AI编程哪家强？Cursor、Trae深度对比，超详细！ - 知乎 Trae兼容vscode的插件，我们可以先在vscode里面装好再一…...

编程日记 2025/8/14 4:42:22

vue3的页面跳转方法汇总(路由跳转，组件跳转)

1.组件跳转使用router-link组件进行组件导航（无需引入该组件，可直接使用），to后面跟组件路由。如果想要在当前页显示跳转的组件，可以通过<router-view>来显示当前路由匹配到的组件，也可以不使用<r…...

编程日记 2025/6/29 2:29:48

自实现string完整版 my_string.h using namespace std; class mystr{public://mystr();mystr(const char * new_str nullptr);mystr(const mystr & another);char * c_str();~mystr();mystr& operator(const mystr & another);mystr operator(const mystr &…...

编程日记 2025/6/29 8:59:41

OpenMVS 的编译与运行

Title: OpenMVS 的编译与运行文章目录 I. 编译与准备1. 获得源码2. wiki3. 退出 Conda 环境4. 编译5. 数据准备 II. 命令了解1. 稠密重建 DensifyPointCloud2. 曲面重建 ReconstructMesh3. 网格优化 RefineMesh4. 纹理贴图 TextureMesh III. 命令运行1. 运行稠密重建2. 运行网…...

编程日记 2025/8/14 4:40:38

@Transactional注解的使用

目录一.介绍 1.使用Transactional注解的位置 2.Transactional注解的作用二.举例 1.需求场景 2.做法 3.效果展示三.简单总结一.介绍 1.使用Transactional注解的位置我们在Java开发中，一般在service层的方法上，使用Transactional注解&#x…...

编程日记 2025/8/14 4:40:54

路由器NAT回流踩坑

路由器 H3C GR-3000AX-U 不支持NAT回流核心问题定位外网访问 ✅ 非Docker服务（直接运行在宿主机上的服务）可以访问❌ Docker服务无法访问内网访问 ✅ 内网IP访问（无论Docker还是非Docker）正常❌ 内网通过公网IP访问全部失败…...

编程日记 2025/8/14 4:40:39

如何创建RDD

创建RDD（Resilient Distributed Dataset）主要有以下三种方法： 1. 从集合创建RDD 通过将本地集合（如列表、数组）传递给SparkContext的parallelize方法，可以将本地数据转换为RDD。这种方式通常用于测试或开…...

编程日记 2025/8/14 4:43:15

PTS-G5K13M RF Generator 5kW / 13MHz 射频电源User s Manual

PTS-G5K13M RF Generator 5kW / 13MHz 射频电源User s Manual...

编程日记 2025/8/14 4:37:42

vue3父组件调用子组件方法

需求：在vue3中需要在父组件调用子组件的方法思路：通过ref和defineExpose直接暴露给父组件 1.子组件暴露表单验证方法 <template><a-form ref"formRef" :model"formState" :rules"rules"><a-form-item …...

编程日记 2025/8/10 22:19:03

Python小酷库系列：5个常用的dict属性化访问扩展库

5个常用的dict属性化访问扩展库嵌套结构高级功能性能综合建议在前面我们详细讲解了 Box和 Munch这两个dict属性化访问的扩展库，总体而言它们主要用于提升配置文件数据、JSON对象数据的可读性，减少了代码中双引号。在这一领域中还有dotmap、addict 和…...

编程日记 2025/8/14 4:35:56

day009-用户管理专题

文章目录 1. 创建包含时间的文件2. 与用户相关的文件3. 用户分类4. 与用户相关的命令4.1 添加用户4.2 删除用户4.3 查看用户4.4 修改用户密码 5. sudo6. 思维导图7. 老男孩思想-学习方法 1. 创建包含时间的文件或$()是替换符号，可以将命令的结果作为字符串或变量的…...

编程日记 2025/8/10 21:15:55

微信小程序pinia的应用

情景：院校列表的关注状态的实时更新新建一个ts文件存储关注状态，用于集中管理用户“已关注院校”的相关状态和操作 import {definStore} from pinia; import type { College_records } from /types/university;export const useFocusCollegeStore de…...

编程日记 2025/8/14 4:37:44

LWIP的超时事件笔记

那个马蜂佬，刚发就给我两个赞 lwIP超时事件处理简介为每个与外界网络连接的任务都设定了timeout属性，即等待超时时间，例如TCP建立连接超时、ARP缓存表项的时间管理等，都需要超时操作来处理 lwIP超时事件机制一共有四种 2.1&a…...

编程日记 2025/8/12 7:33:27

如何避免项目结束后知识流失

避免项目结束后知识流失的方法包括：建立项目知识库、实施定期知识回顾与总结、强化团队内部知识共享机制、利用合适的知识管理工具。项目知识库的建设尤其关键，它可帮助团队保留核心经验和方法，确保知识沉淀在组织内部。通过知识库&#xff0…...

编程日记 2025/8/9 17:15:12

【MCP】客户端配置（ollama安装、qwen2.5:0.5b模型安装、cherry-studio安装配置）

【MCP】客户端配置（ollama安装、qwen2.5:0.5b模型安装、cherry-studio安装配置） 客户端配置（1）下载安装ollama（2）安装qwen2.5:0.5b模型（3）安装配置cherry-studio 客户端配置 &#…...

编程日记 2025/6/29 4:10:41

Media3 中 Window 的时间相关属性详解

AndroidX Media3 的 Timeline.Window 类中，与时间相关的属性描述了媒体播放窗口（window）在时间维度上的关键信息。这些属性帮助开发者理解媒体的播放范围、起始点、持续时间以及与设备时间或直播流的同步关系。 Timeline.Window 的时间相关属…...

编程日记 2025/6/29 4:53:32

C 语言编码规范

在 C 语言开发过程中，遵循编码规范不仅能提高代码的可读性、可维护性，还能减少潜在的错误，提升团队协作效率。以下从多个维度详细阐述 C 语言编码过程中需要注意的规范要点。一、命名规范变量命名变量命名应做到见名知意，采用…...

编程日记 2025/8/12 7:52:30

嵌入式开发学习日志Day15

一、指针指向字符型数组 （1）【const】：在指针变量中使用时，无法通过该指针修改被指向的变量； （2）【const】：关键字，在C和C中，能加就加，加了一定…...

编程日记 2025/6/29 5:07:32

从人脸扫描到实时驱动，超写实数字分身技术解析

在元宇宙浪潮中，数字人、虚拟数字人等新兴概念逐渐走进大众视野，其中数字分身作为虚拟数字人的细分领域，正引发广泛关注。数字分身依托人工智能与虚拟现实技术，能基于真人信息进行1:1复刻，具备与真人高度相似的外貌、声…...

编程日记 2025/6/29 4:39:37

Vue3 自定义指令的原理，以及应用

文章目录前言一、原理说明二、注册与使用1. 全局注册2. 局部注册3. 使用方式三、典型应用场景四、案例：权限控制指令五、注意事项 v-draggable✅ 目标效果：🧩 1. 自定义指令定义🧱 2. 在项目中注册🧪 3. 使用示例&am…...

编程日记 2025/6/29 3:36:49

306.检查是否所有A都在B之前

2124. 检查是否所有 A 都在 B 之前 - 力扣（LeetCode） class Solution {public boolean checkString(String s) {return !s.contains("ba");} } class Solution(object):def checkString(self, s):return s.find("ba")-1...

编程日记 2025/8/11 22:53:20

适合java程序员的Kafka消息中间件实战

创作的初心： 我们在学习kafka时，都是基于大数据的开发而进行的讲解，这篇文章为java程序员为核心，助力大家掌握kafka实现。什么是kafka: 历史： 诞生与开源（2010 - 2011 年） 2010 年&#xf…...

编程日记 2025/6/29 3:32:04

当体育数据API遇上WebSocket：一场技术互补的「攻防战」

在世界杯决赛的最后一分钟，你正通过手机观看直播。突然，解说员大喊“球进了！”，但你的屏幕却卡在对方半场的回放画面——这种「延迟乌龙」的尴尬，正是实时体育应用面临的终极挑战。在体育数字化浪潮下，用…...

编程日记 2025/6/29 4:12:22

1：点云处理—三种显示方法（自建点云）

1.彩色显示 *读取三维点云 dev_get_window(WindowHandle)dev_open_window(0, 0, 512, 512, black, WindowHandle1) read_object_model_3d(./19-12-26/t.ply, m, [], [], ObjectModel3D, Status)Instructions[0] : Rotate: Left button Instructions[1] : Zoom: Shift left…...

编程日记 2025/6/29 4:14:48

SCADA|KingSCADA运行报错：加载实时库服务失败

哈喽，你好啊，我是雷工！最近在绵阳出差，在现场调试时遇到报错问题，翻了下以往记录没有该错误的相关笔记。于是将问题过程及处理办法记录下来。 01 问题描述昨天还好好的，可以正常运行的程序今天再次运行时报错： “加载实时库服务失败” 查看日志中错误信息如下： …...

编程日记 2025/6/29 4:23:15

k8s | Kubernetes 服务暴露：NodePort、Ingress 与 YAML 配置详解

CodingTechWork 引言在 Kubernetes 集群中，服务暴露是将集群内部的服务对外部网络提供访问的关键环节。NodePort 和 Ingress 是两种常用的服务暴露方式，它们各有特点和适用场景。本文将详细介绍这两种方式的原理、配置方法以及如何通过 YAML 文件实现服…...

编程日记 2025/6/29 4:22:27

upload-labs靶场通关详解：第一关

一、一句话木马准备新建一个文本文档，写入php代码，修改文件后缀名为php，保存。 phpinfo() 是 PHP 里的一个内置函数，其功能是输出关于当前 PHP 环境的详细信息。这些信息涵盖 PHP 版本、服务器配置、编译选项、PHP 扩展、环境变…...

编程日记 2025/6/29 4:28:33

SSA-CNN+NSGAII+熵权TOPSIS，附相关气泡图！

目录效果一览基本介绍程序设计参考资料效果一览基本介绍经典麻雀搜索算法深度学习多目标优化多属性决策！SSA-CNNNSGAII熵权TOPSIS，附相关气泡图！本文旨在通过优化卷积神经网络（CNN）以及采用NSGAII多目标优化与熵权…...

编程日记 2025/8/9 17:34:36

数据结构之栈与队列

一，栈和队列的区别 1、核心定义与特性特性栈（Stack）队列（Queue）定义仅允许在栈顶（表尾）进行插入和删除的线性表，遵循后进先出（LIFO）。允许在队尾插入、队…...

编程日记 2025/6/29 2:25:08

SSHv2 密钥交换（Key Exchange）详解

1. 算法协商在密钥交换开始前，客户端和服务端会协商确定本次会话使用的算法组合。具体过程如下： 交换算法列表客户端和服务端各自发送支持的算法列表，包括： 密钥交换算法（如 diffie-hellman-group14-sha256&#xf…...

编程日记 2025/6/29 4:55:15

从零开始学习three.js（15）：一文详解three.js中的纹理映射UV

1. UV 映射基础概念 1.1 什么是 UV 坐标？ 在三维计算机图形学中，UV 坐标是将二维纹理映射到三维模型表面的坐标系统。UV 中的 U 和 V 分别代表2D纹理空间的水平（X）和垂直（Y）坐标轴，与三维空间…...

编程日记 2025/8/12 10:46:07

解锁 Postgres 扩展日！与瀚高共探 C/Java 跨语言扩展技术的边界与未来

2025 年 5 月 13 日至 16 日（蒙特利尔时间），一年一度的 PostgreSQL 开发者大会 PGConf.dev（原 PGCON 会议）将在加拿大蒙特利尔盛大举行。同去年一样，在本次大会开幕的前一天同样会举办另外一个专场活动——…...

编程日记 2025/6/29 2:25:04