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;

