Spring Boot 3 + Java 21 环境配置步骤(适合 Windows / macOS / Linux):
一、安装 Java 21 (LTS)
1. 下载
推荐使用 OpenJDK 版本(免费、稳定):
- Oracle JDK 21:https://www.oracle.com/java/technologies/downloads/
- Eclipse Temurin (Adoptium):https://adoptium.net/temurin/releases/
- Microsoft Build of OpenJDK:https://learn.microsoft.com/en-us/java/openjdk/download
安装后,在命令行输入:
java -version
应输出类似:
openjdk version "21.0.1" 2025-01-01
OpenJDK Runtime Environment (build 21.0.1+12)
OpenJDK 64-Bit Server VM (build 21.0.1+12, mixed mode, sharing)
二、配置环境变量(Windows)
- 打开系统环境变量 → Path
- 新建: JAVA_HOME = C:\Program Files\Eclipse Adoptium\jdk-21
- 在 Path 中添加: %JAVA_HOME%\bin
测试:
echo %JAVA_HOME%
java -version
三、安装构建工具
1. Maven(推荐)
下载:https://maven.apache.org/download.cgi
配置环境变量:
MAVEN_HOME = C:\apache-maven-3.9.9
Path += %MAVEN_HOME%\bin
测试:
mvn -v
2. 或使用 Gradle:
gradle -v
四、安装 IDE
推荐:
- IntelliJ IDEA(社区版免费)
- Spring Tools Suite (STS)
- VS Code + Spring Boot 插件
五、新建 Spring Boot 3 项目
使用 Spring Initializr(官网自动生成项目结构):
配置选项:
| 项目项 | 选择值 |
|---|---|
| Project | Maven Project |
| Language | Java |
| Spring Boot | 3.3.x(最新) |
| Packaging | Jar |
| Java | 21 |
| Dependencies | Spring Web, Spring Boot DevTools, Lombok, Spring Data JPA, MySQL Driver |
点击 “Generate” 下载后解压。
六、项目配置文件示例
pom.xml:
21
3.3.4
application.yml:
server:
port: 8080
spring:
datasource:
url: jdbc:mysql://localhost:3306/testdb?useSSL=false&serverTimezone=UTC
username: root
password: root
jpa:
hibernate:
ddl-auto: update
show-sql: true
七、测试运行
命令行进入项目根目录执行:
mvn spring-boot:run
输出如下表示启动成功:
Tomcat started on port(s): 8080
Started DemoApplication in 2.345 seconds
访问浏览器:
http://localhost:8080
提示
- 部分类库迁移到了 jakarta.* 包名,例如: import jakarta.persistence.Entity; import jakarta.servlet.http.HttpServletRequest;

