跳到主要内容

环境配置

本章将介绍如何搭建 Spring Boot 开发环境，包括 JDK 安装、IDE 配置和项目创建方式。

系统要求​

Java 版本要求​

Spring Boot 对 Java 版本有明确要求：

Spring Boot 版本最低 Java 版本推荐 Java 版本
2.xJava 8Java 11
3.0 - 3.1Java 17Java 17
3.2+Java 17Java 21

重要说明：Spring Boot 3.x 要求最低 Java 17，这是因为 Spring Boot 3.x 基于 Spring Framework 6，而 Spring Framework 6 要求 Java 17+。

检查 Java 版本​

打开命令行，执行以下命令：

java -version

输出示例：

java version "17.0.8" 2023-07-18 LTS
Java(TM) SE Runtime Environment (build 17.0.8+9-LTS-211)
Java HotSpot(TM) 64-Bit Server VM (build 17.0.8+9-LTS-211, mixed mode, sharing)

解释：确保你的 Java 版本满足 Spring Boot 的最低要求。如果版本过低，需要升级 JDK。

安装 JDK​

Windows 系统​

  1. 下载 JDK

    访问 Oracle JDK 官网 或使用开源版本 Adoptium 下载 JDK 17 或更高版本。

    推荐使用 Adoptium Temurin，这是一个开源免费的 JDK 发行版。

  2. 安装 JDK

    运行下载的安装程序，按照向导完成安装。

  3. 配置环境变量

    • 右键"此电脑" → "属性" → "高级系统设置" → "环境变量"
    • 新建系统变量 JAVA_HOME，值为 JDK 安装路径（如 C:\Program Files\Java\jdk-17）
    • 编辑系统变量 Path，添加 %JAVA_HOME%\bin

  4. 验证安装

    java -version
    javac -version

macOS 系统​

  1. 使用 Homebrew 安装

    # 安装 Homebrew（如果未安装）
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

    # 安装 JDK 17
    brew install openjdk@17

    # 创建符号链接
    sudo ln -sfn /opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk-17.jdk

  2. 配置环境变量

    编辑 ~/.zshrc 或 ~/.bash_profile：

    export JAVA_HOME=$(/usr/libexec/java_home -v 17)
    export PATH=$JAVA_HOME/bin:$PATH

  3. 使配置生效

    source ~/.zshrc

Linux 系统​

  1. 使用包管理器安装

    Ubuntu/Debian：

    sudo apt update
    sudo apt install openjdk-17-jdk

    CentOS/RHEL：

    sudo yum install java-17-openjdk-devel

  2. 配置环境变量

    编辑 /etc/profile 或 ~/.bashrc：

    export JAVA_HOME=/usr/lib/jvm/java-17-openjdk
    export PATH=$JAVA_HOME/bin:$PATH

  3. 使配置生效

    source ~/.bashrc

构建工具​

Spring Boot 支持 Maven 和 Gradle 两种构建工具。

Maven​

安装 Maven​

Windows：

  1. 下载 Apache Maven
  2. 解压到指定目录（如 C:\Program Files\Apache\maven）
  3. 配置环境变量：
    • 新建 MAVEN_HOME，值为 Maven 安装路径
    • 在 Path 中添加 %MAVEN_HOME%\bin

macOS/Linux：

# 使用 Homebrew
brew install maven

# 或使用包管理器
sudo apt install maven  # Ubuntu/Debian

验证安装​

mvn -version

输出示例：

Apache Maven 3.9.5
Maven home: /usr/local/Cellar/maven/3.9.5/libexec
Java version: 17.0.8, vendor: Oracle Corporation

Maven 配置优化​

编辑 Maven 配置文件 settings.xml（位于 ~/.m2/ 目录）：

<settings>
    <!-- 本地仓库路径 -->
    <localRepository>D:/maven/repository</localRepository>
    
    <!-- 镜像配置（使用阿里云镜像加速） -->
    <mirrors>
        <mirror>
            <id>aliyun</id>
            <mirrorOf>central</mirrorOf>
            <name>Aliyun Maven Mirror</name>
            <url>https://maven.aliyun.com/repository/public</url>
        </mirror>
    </mirrors>
    
    <!-- 全局 JDK 版本 -->
    <profiles>
        <profile>
            <id>jdk-17</id>
            <activation>
                <activeByDefault>true</activeByDefault>
                <jdk>17</jdk>
            </activation>
            <properties>
                <maven.compiler.source>17</maven.compiler.source>
                <maven.compiler.target>17</maven.compiler.target>
            </properties>
        </profile>
    </profiles>
</settings>

解释：

  • localRepository：指定本地仓库位置，避免占用 C 盘空间
  • mirrors：使用国内镜像加速依赖下载
  • profiles：设置全局 JDK 编译版本

Gradle​

安装 Gradle​

Windows：

  1. 下载 Gradle
  2. 解压到指定目录
  3. 配置环境变量

macOS/Linux：

# 使用 SDKMAN
curl -s "https://get.sdkman.io" | bash
sdk install gradle

# 或使用 Homebrew
brew install gradle

验证安装​

gradle -version

Gradle 配置优化​

编辑 gradle.properties（位于 ~/.gradle/ 目录）：

# 使用阿里云镜像
systemProp.http.proxyHost=maven.aliyun.com
systemProp.http.proxyPort=80

# 增加内存
org.gradle.jvmargs=-Xmx2048m -XX:+HeapDumpOnOutOfMemoryError

# 开启并行编译
org.gradle.parallel=true

# 开启构建缓存
org.gradle.caching=true

Maven vs Gradle 对比​

特性MavenGradle
配置方式XMLGroovy/Kotlin DSL
构建速度较慢较快（增量编译）
灵活性约定优于配置更灵活
学习曲线较低较高
生态支持更成熟发展迅速
适用场景传统企业项目现代敏捷项目

选择建议：

  • 新手推荐使用 Maven，学习资源更丰富
  • 追求构建性能推荐使用 Gradle
  • 团队协作时保持一致性更重要

IDE 配置​

IntelliJ IDEA（推荐）​

IntelliJ IDEA 是开发 Spring Boot 应用的最佳选择，提供强大的代码提示和调试功能。

安装 IDEA​

  1. 下载 IntelliJ IDEA
  2. 社区版（Community）免费，旗舰版（Ultimate）收费

推荐使用旗舰版，因为它提供了：

  • Spring 框架支持
  • 数据库工具
  • Web 开发工具
  • 更多高级功能

安装插件​

在 IDEA 中，进入 Settings → Plugins，安装以下插件：

插件名称功能
Spring Boot HelperSpring Boot 代码提示和配置支持
Lombok自动生成 getter/setter 等
MyBatisXMyBatis 开发支持
Maven HelperMaven 依赖分析

配置 JDK​

  1. 进入 File → Project Structure → SDKs
  2. 点击 + 添加 JDK
  3. 选择 JDK 安装目录

配置 Maven​

  1. 进入 Settings → Build, Execution, Deployment → Build Tools → Maven
  2. 设置 Maven home path
  3. 设置 User settings file
  4. 设置 Local repository

VS Code​

VS Code 是轻量级的编辑器选择。

安装扩展​

安装 Extension Pack for Java：

包含以下扩展：

  • Language Support for Java
  • Debugger for Java
  • Maven for Java
  • Gradle for Java
  • Test Runner for Java

安装 Spring Boot Extension Pack：

包含以下扩展：

  • Spring Boot Tools
  • Spring Initializr
  • Spring Boot Dashboard

创建项目​

Spring Boot 提供了多种创建项目的方式。

方式一：Spring Initializr（Web 界面）​

  1. 访问 Spring Initializr

  2. 配置项目信息：

    • Project: Maven / Gradle
    • Language: Java
    • Spring Boot: 选择稳定版本（如 3.2.x）
    • Group: 项目组织名（如 com.example）
    • Artifact: 项目名称（如 demo）
    • Package name: 包名（如 com.example.demo）
    • Packaging: Jar（推荐）/ War
    • Java: 选择 Java 版本

  3. 添加依赖：

    • 点击 ADD DEPENDENCIES
    • 搜索并添加所需依赖（如 Spring Web）

  4. 点击 GENERATE 下载项目压缩包

  5. 解压后用 IDE 打开项目

方式二：IDEA 创建​

  1. 打开 IDEA，选择 New Project
  2. 选择 Spring Initializr
  3. 填写项目信息和依赖
  4. 点击 Create

方式三：命令行创建​

使用 Spring Boot CLI：

# 安装 Spring Boot CLI（macOS）
brew install springboot

# 创建项目
spring init --dependencies=web,data-jpa myproject

使用 curl 调用 Spring Initializr API：

curl https://start.spring.io/starter.zip \
  -d type=maven-project \
  -d language=java \
  -d bootVersion=3.2.0 \
  -d groupId=com.example \
  -d artifactId=demo \
  -d name=demo \
  -d packageName=com.example.demo \
  -d javaVersion=17 \
  -d dependencies=web,devtools \
  -o demo.zip

项目结构​

创建完成后的项目结构如下：

demo/
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── com/example/demo/
│   │   │       └── DemoApplication.java    # 主启动类
│   │   └── resources/
│   │       ├── static/                     # 静态资源
│   │       ├── templates/                  # 模板文件
│   │       └── application.properties      # 配置文件
│   └── test/
│       └── java/
│           └── com/example/demo/
│               └── DemoApplicationTests.java
├── .gitignore
├── HELP.md
├── mvnw                                     # Maven Wrapper（Unix）
├── mvnw.cmd                                 # Maven Wrapper（Windows）
├── pom.xml                                  # Maven 配置文件
└── README.md

目录说明：

目录/文件说明
src/main/javaJava 源代码
src/main/resources资源文件
static/静态资源（CSS、JS、图片）
templates/模板文件（Thymeleaf 等）
application.properties应用配置文件
src/test/java测试代码
pom.xmlMaven 项目配置

运行项目​

使用 Maven​

# Windows
mvnw.cmd spring-boot:run

# macOS/Linux
./mvnw spring-boot:run

使用 Gradle​

# Windows
gradlew.bat bootRun

# macOS/Linux
./gradlew bootRun

使用 IDE​

  1. 打开主启动类（*Application.java）
  2. 点击类或 main 方法旁边的绿色运行按钮
  3. 选择 Run 或 Debug

验证运行​

项目启动后，访问 http://localhost:8080，如果看到 Whitelabel Error Page 或自定义页面，说明项目运行成功。

常见问题​

1. 端口被占用​

错误信息：

Web server failed to start. Port 8080 was already in use.

解决方案：

方式一：修改端口

在 application.properties 中：

server.port=8081

方式二：终止占用端口的进程

# Windows
netstat -ano | findstr :8080
taskkill /PID <PID> /F

# macOS/Linux
lsof -i :8080
kill -9 <PID>

2. 依赖下载失败​

解决方案：

  1. 检查网络连接
  2. 配置国内镜像（如阿里云）
  3. 清除本地仓库缓存：
mvn dependency:purge-local-repository

3. Java 版本不匹配​

错误信息：

java: invalid source release: 17

解决方案：

确保项目、Maven/Gradle 和 JDK 版本一致：

<!-- pom.xml -->
<properties>
    <java.version>17</java.version>
</properties>
// build.gradle
java {
    sourceCompatibility = JavaVersion.VERSION_17
}

小结​

本章我们学习了：

  1. 系统要求：确认 Java 版本满足 Spring Boot 要求
  2. JDK 安装：在 Windows、macOS、Linux 上安装 JDK
  3. 构建工具：Maven 和 Gradle 的安装与配置
  4. IDE 配置：IntelliJ IDEA 和 VS Code 的配置
  5. 项目创建：使用 Spring Initializr 创建项目
  6. 项目结构：了解 Spring Boot 项目目录结构
  7. 运行项目：多种方式运行 Spring Boot 应用

练习​

  1. 安装 JDK 17 并验证安装
  2. 配置 Maven 并设置阿里云镜像
  3. 使用 Spring Initializr 创建一个 Web 项目
  4. 运行项目并访问 http://localhost:8080
  5. 尝试修改端口为 9090 并重新运行