第 1 节:使用 IDEA 创建 SpringBoot4 Maven 项目

第 1 节:使用 IDEA 创建 SpringBoot4 Maven 项目

环境前提:JDK21、Maven3.9+、MySQL8、Redis 已就绪

工具:IntelliJ IDEA(推荐社区版 / 旗舰版,2024 及以上版本,原生支持 JDK21)

1.1 新建项目

  1. IDEA 打开 → New Project → 选择 Spring Initializr(Spring 官方脚手架)
  2. 填写项目基础信息:
  • Service URL:默认 https://start.spring.io
  • Type :Maven Project(重点,不是 Gradle)
  • Language :Java
  • Group :com.demo(组织包名,自定义)
  • Artifact :springboot4-demo(项目名)
  • Name :springboot4-demo
  • Description :SpringBoot4 Maven Demo
  • Package name :com.demo.springboot4demo
  • Packaging :Jar
  • Java :21(必须选 21!SpringBoot4 最低要求)
  • Spring Boot Version :4.0.x(不带 M、SNAPSHOT,选正式版)
  1. 勾选依赖(本节只勾选基础依赖,后续模块按需新增)
    ✅ Spring Web:web 接口,写 http 接口必备
    ✅ Spring Data Redis:redis 整合
    ✅ MySQL Driver:mysql 驱动
    ✅ Spring Data JPA(或者 MyBatis,我们后面选 MyBatis-Plus,这里先只勾选基础驱动)

现在只勾选这 3 个核心依赖,MyBatis-Plus 手动在 pom.xml 引入,脚手架没有。

  1. 点击 Create,等待 IDEA 自动拉取 Maven 依赖。

⚠️ 如果下载很慢:检查前面配置的 maven settings.xml 阿里云镜像,IDEA 里面确认 Maven 使用自己本地的 Maven,不是内置 Maven。

IDEA 设置:File -> Settings -> Build, Execution, Deployment -> Build Tools -> Maven

Maven home:选择你本地解压的 maven3.9 目录,不要选 bundled。

✅ 当前页面勾选指引(SpringBoot 4.1.1)

你现在这个界面,需要勾选 3 个依赖:

  1. ✅ Spring Web(就是当前选中这一行,打勾,提供 web 接口能力)
  2. ✅ Spring Data Redis:往下滚动列表找到这个,勾选,用来整合 Redis
  3. ✅ MySQL Driver:继续往下翻找到,勾选,MySQL 驱动

小提示:可以在顶部搜索框直接搜索名字快速定位,不用手动翻:

  • 搜索 Spring Web
  • 搜索 Spring Data Redis
  • 搜索 MySQL Driver

不要勾选:

Spring Data JPA、Spring Reactive Web 这些暂时不选,我们后面用 MyBatis-Plus,手动在 pom 引入。

可选推荐(开发神器,建议勾上)

Developer Tools → Spring Boot DevTools

作用:代码修改自动重启服务,开发调试很方便。


操作顺序:

  1. 勾选上面 3 个核心依赖(可选加上 DevTools)
  2. 右侧 Added dependencies 列表会出现你选中的这几项
  3. 点击右下角 Create 创建项目

创建完成后等待 IDEA 下载 Maven 依赖。

完成后我们做本节测试:刷新 maven、运行启动类,看是否正常启动。

1.2 查看自动生成的 pom.xml

打开 pom.xml,确认父工程版本是 SpringBoot4:

复制代码
<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>4.0.0</version>
    <relativePath/> <!-- lookup parent from repository -->
</parent>

已自动包含我们勾选的 starter:

  • spring-boot-starter-web
  • spring-boot-starter-data-redis
  • mysql-connector-j

1.3 项目目录结构(Maven 标准)

复制代码
springboot4-demo
├── src
│   ├── main
│   │   ├── java
│   │   │   └── com
│   │   │       └── demo
│   │   │           └── springboot4demo
│   │   │               └── Springboot4DemoApplication.java  //启动类
│   │   └── resources
│   │       ├── static
│   │       ├── templates
│   │       └── application.properties  //配置文件
│   └── test
│       └── java
└── pom.xml

1.4 第 1 节 场景测试

测试任务 1:确认 Maven 依赖加载完成

右侧 Maven 面板,刷新按钮🔄,看有没有红色报错。无红色代表依赖拉取成功。

测试任务 2:运行启动类

打开 Springboot4DemoApplication.java,右键 Run,观察控制台输出:

  1. 启动成功标志:Started Springboot4DemoApplication in xxx seconds
  2. 默认端口:8080

访问浏览器 / Postman:http://localhost:8080

SpringBoot 默认没有首页,会出现 Whitelabel Error Page,这个是正常现象! 代表服务成功跑起来,只是还没写接口。

问题分析

java: 警告:源发行版 21 需要目标发行版 21

这个是IDEA 项目 SDK 和语言级别不匹配,SpringBoot4 要求源码和目标字节码版本都是 21,当前项目编译配置不对。

修复步骤

步骤 1:打开项目结构设置

快捷键:Ctrl + Alt + Shift + S

或者菜单 File -> Project Structure

  1. Project 选项卡
    • Project SDK:选择 21
    • Project language level:21 - Sealed classes, pattern matching for switch
  2. Modules 选项卡,选中你的 szyj 模块
    • Module SDK:21
    • Language level:同样选 21
      点击 Apply → OK

步骤 2:检查 Maven 编译配置(pom.xml)

打开 pom.xml,确认里面有下面配置(SpringBoot 父工程一般自带,没有就手动添加)

复制代码
<properties>
    <java.version>21</java.version>
</properties>

步骤 3:刷新 Maven + 清除缓存

  1. 右侧 Maven 面板,点🔄刷新按钮 Reload All Maven Projects
  2. 菜单 File -> Invalidate Caches... → 勾选 Clear file system cache and local history → Invalidate and Restart,重启 IDEA

步骤 4:重新运行启动类

重启完成后,打开 SzyjApplication.java,点击 main 方法左边绿色三角运行。


测试标准

✅ 正常:控制台不再报这个发行版警告,输出 SpringBoot 启动日志,最后出现 Started SzyjApplication

相关推荐
雪芽蓝域zzs2 小时前
第 8 节:SpringBoot3 整合 Redis7
spring boot
Flynn Liang4 小时前
Java 虚拟线程别乱用:I/O 密集型服务的线程模型与并发度计算
java·spring boot·性能优化·高并发·线程池·虚拟线程
雪芽蓝域zzs6 小时前
第 3 章:完成 User 完整 CRUD(新增、根据 id 查询、修改、删除、查询全部)
spring boot
她的男孩8 小时前
审批人选了「部门主管」,发起却报 Unknown property:Forge Admin 启动时补齐组织变量
spring boot·低代码·工作流引擎
wno7049 小时前
springboot整合FastDFS
java·spring boot·后端
一起_java18 小时前
技术文章-基于Dify-Agent的智能问答系统设计与实现
java·spring boot·后端·agent·dify
Flynn Liang19 小时前
I/O 密集型高并发实战:Java 服务 10 维优化,从线程打满到 10 万 QPS
java·spring boot·性能优化·高并发·系统设计·虚拟线程·io密集型
Flynt1 天前
掘金热文说 Spring Boot 4.1 默认开虚拟线程,我实测后发现了更狠的坑
java·spring boot·性能优化
杨凯凡1 天前
Spring Boot 事务提交后消息仍会丢?TransactionalEventListener 与 Outbox 可靠投递实战
java·spring boot
学长毕设2 天前
基于SpringBoot军事纪念馆管理系统设计与实现-附源码
java·spring boot·后端