1. 为什么你的REST API总被CORS问题困扰?
每次看到浏览器控制台那个鲜红的CORS错误提示,是不是感觉血压都上来了?作为一个经历过无数次跨域折磨的老司机,我完全理解这种痛苦。想象一下这样的场景:你花了两天时间开发的前端页面,调用自己写的后端接口时,浏览器却无情地抛出了"Access-Control-Allow-Origin"错误。这种挫败感,我懂。
其实CORS问题本质上是个"保安问题"。浏览器就像个尽职的保安,严格执行"同源政策"——只允许页面与相同协议、域名和端口的服务通信。这个机制虽然保护了用户安全,却给开发者带来了不少麻烦。特别是在前后端分离架构成为主流的今天,前端运行在localhost:3000,后端在localhost:8080,这种跨域情况简直不要太常见。
我见过太多开发者习惯性地在遇到CORS错误时,才手忙脚乱地去找解决方案。这种"事后补救"的做法不仅效率低下,还可能导致安全隐患。正确的做法应该是在项目搭建之初,就系统性地规划好跨域策略。这样不仅能避免开发过程中的各种阻塞,还能确保生产环境的安全性。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 从零搭建Spring Boot项目
2.1 初始化项目骨架
让我们从最基础的开始——创建一个全新的Spring Boot项目。我强烈推荐使用Spring Initializr(https://start.spring.io/),这是官方提供的项目初始化工具,简单易用。
打开网页后,我们需要做几个关键选择:
- 项目类型:Gradle或Maven(我个人偏好Gradle,构建速度更快)
- 语言:Java
- Spring Boot版本:选择最新的稳定版
- 项目元数据:填写你的Group和Artifact
- 依赖项:至少添加"Spring Web"
点击生成按钮后,你会下载到一个压缩包。解压后用你喜欢的IDE(IntelliJ IDEA或Eclipse)打开。项目结构应该类似这样:
code复制todo-api/
├── src/
│ ├── main/
│ │ ├── java/com/example/todoapi
│ │ │ ├── TodoApiApplication.java
│ │ ├── resources
│ │ │ ├── application.properties
├── build.gradle
2.2 编写第一个REST端点
为了演示CORS配置,我们先创建一个简单的待办事项API。在java/com/example/todoapi目录下新建TodoController.java:
java复制@RestController
@RequestMapping("/api/todos")
public class TodoController {
private List<Todo> todos = new ArrayList<>();
@GetMapping
public List<Todo> getAllTodos() {
