安装

Springboot文档 (PHP社区风格) /

Spring Boot 安装与配置完整指南

系统要求

在安装 Spring Boot 之前，请确保您的系统满足以下要求：
• Java JDK 8 或更高版本（推荐 JDK 11 或 17）

• Maven 3.3+ 或 Gradle 6.x+（构建工具）

• 开发工具（推荐 IntelliJ IDEA 或 Eclipse with STS 插件）

Java 安装与配置

2.1 安装 JDK

下载适合您操作系统的 JDK：
• Oracle JDK

• OpenJDK

安装 JDK（以 Windows 为例）：
• 运行下载的安装程序

• 按照向导完成安装

• 默认安装路径通常为 C:\Program Files\Java\jdk-版本号

2.2 配置环境变量

设置 JAVA_HOME：

JAVA_HOME=C:\Program Files\Java\jdk-17.0.1

将 JDK 添加到 PATH：
```
PATH=%JAVA_HOME%\bin;...
```
验证安装：
```
java -version
javac -version
```
构建工具安装

3.1 Maven 安装

下载 Maven：
• Apache Maven 官网

解压到指定目录（如 C:\apache-maven-3.8.4）

配置环境变量：

MAVEN_HOME=C:\apache-maven-3.8.4
PATH=%MAVEN_HOME%\bin;...

验证安装：
```
mvn -v
```

3.2 Gradle 安装（可选）

下载 Gradle：
• Gradle 官网

配置环境变量：

GRADLE_HOME=C:\gradle-7.4.2
PATH=%GRADLE_HOME%\bin;...

验证安装：
```
gradle -v
```
创建 Spring Boot 项目

4.1 使用 Spring Initializr（推荐）

访问 start.spring.io
选择项目配置：
• Project: Maven 或 Gradle

• Language: Java

• Spring Boot: 选择最新稳定版

• Group: 公司域名反写（如 com.example）

• Artifact: 项目名称

• Packaging: Jar（默认）

• Java: 选择与安装一致的版本

添加依赖（根据需要选择）：
• Spring Web (web)

• Spring Data JPA (data-jpa)

• Spring Security (security)

• Thymeleaf (thymeleaf)

• Lombok (lombok)

• DevTools (devtools)

点击 “Generate” 下载项目压缩包

4.2 使用命令行创建

# 使用curl
curl https://start.spring.io/starter.zip -d dependencies=web,data-jpa -d javaVersion=17 -o myproject.zip

# 或使用HTTPie
http https://start.spring.io/starter.zip dependencies==web,data-jpa javaVersion==17 > myproject.zip

4.3 使用IDE创建（IntelliJ IDEA）

打开 IntelliJ IDEA
选择 “File” > “New” > “Project”
选择 “Spring Initializr”
填写项目信息（同网页版）
选择依赖项
完成创建
项目结构说明

解压或创建后的标准项目结构：

myproject/
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── com/example/myproject/
│   │   │       └── MyprojectApplication.java  # 主启动类
│   │   └── resources/
│   │       ├── static/      # 静态资源(JS/CSS/图片)
│   │       ├── templates/   # 模板文件(Thymeleaf等)
│   │       ├── application.properties  # 配置文件
│   │       └── ...
│   └── test/                # 测试代码
├── .gitignore
├── pom.xml                  # Maven配置文件
└── README.md

运行 Spring Boot 应用

6.1 使用 IDE 运行

打开主启动类 (*Application.java)
点击运行按钮（通常有绿色箭头图标）
或右键选择 “Run ‘主类名’”

6.2 使用命令行运行

# Maven项目
mvn spring-boot:run

# 或先打包再运行
mvn clean package
java -jar target/myproject-0.0.1-SNAPSHOT.jar

# Gradle项目
gradle bootRun
gradle build
java -jar build/libs/myproject-0.0.1-SNAPSHOT.jar

基本配置

7.1 配置文件

Spring Boot 支持两种格式的配置文件：
• application.properties (传统格式)

• application.yml (YAML格式，推荐)

application.properties 示例

# 服务器配置
server.port=8080
server.servlet.context-path=/api

# 数据库配置
spring.datasource.url=jdbc:mysql://localhost:3306/mydb
spring.datasource.username=root
spring.datasource.password=123456
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

# JPA配置
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true

application.yml 示例

server:
  port: 8080
  servlet:
    context-path: /api

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/mydb
    username: root
    password: 123456
    driver-class-name: com.mysql.cj.jdbc.Driver
  jpa:
    hibernate:
      ddl-auto: update
    show-sql: true

7.2 多环境配置

可以创建不同环境的配置文件：
• application-dev.yml (开发环境)

• application-test.yml (测试环境)

• application-prod.yml (生产环境)

通过激活指定配置文件：

# application.yml
spring:
  profiles:
    active: dev

或通过命令行激活：

java -jar myapp.jar --spring.profiles.active=prod

常用依赖说明

8.1 Web 开发

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

包含：
• Spring MVC

• 嵌入式 Tomcat

• Jackson (JSON处理)

8.2 数据库访问

<!-- JPA + Hibernate -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>

<!-- JDBC -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-jdbc</artifactId>
</dependency>

<!-- MySQL驱动 -->
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <scope>runtime</scope>
</dependency>

8.3 模板引擎

<!-- Thymeleaf -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>

<!-- Freemarker -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-freemarker</artifactId>
</dependency>

8.4 开发工具

<!-- 热部署 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-devtools</artifactId>
    <scope>runtime</scope>
    <optional>true</optional>
</dependency>

<!-- Lombok (简化代码) -->
<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <optional>true</optional>
</dependency>

开发工具配置

9.1 热部署配置

确保添加了 spring-boot-devtools 依赖
IntelliJ IDEA 设置：
• “File” > “Settings” > “Build, Execution, Deployment” > “Compiler”

• 勾选 “Build project automatically”

• 注册表 (Ctrl+Shift+A 搜索 “Registry”)，勾选：

◦ compiler.automake.allow.when.app.running

◦ actionSystem.assertFocusAccessFromEdt

9.2 自动重启

DevTools 会监控 classpath 下的文件变动自动重启应用。排除不需要监控的资源：

spring.devtools.restart.exclude=static/**,public/**,templates/**

打包与部署

10.1 打包为可执行JAR

mvn clean package
# 生成的JAR位于 target/目录下

10.2 打包为WAR（部署到外部容器）

修改 pom.xml：

<packaging>war</packaging>

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-tomcat</artifactId>
    <scope>provided</scope>
</dependency>

修改主启动类：

@SpringBootApplication
public class Application extends SpringBootServletInitializer {
    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) {
        return builder.sources(Application.class);
    }

    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

打包：

mvn clean package
# 生成的WAR位于 target/目录下

10.3 Docker 部署

创建 Dockerfile：

FROM openjdk:17-jdk-slim
ARG JAR_FILE=target/*.jar
COPY ${JAR_FILE} app.jar
ENTRYPOINT ["java","-jar","/app.jar"]

构建镜像：
```
docker build -t my-spring-app .
```
运行容器：
```
docker run -p 8080:8080 my-spring-app
```
验证安装

访问默认端点验证应用是否正常运行：
• http://localhost:8080/actuator/health (需添加actuator依赖)

• 或创建测试控制器：

@RestController
public class TestController {
    @GetMapping("/hello")
    public String hello() {
        return "Spring Boot is working!";
    }
}

访问 http://localhost:8080/hello 应看到返回消息。

常见问题解决

12.1 端口冲突

# 修改应用端口
server.port=8081

12.2 依赖下载失败

检查网络连接
尝试更换 Maven 镜像源（修改 settings.xml）：

<mirror>
    <id>aliyunmaven</id>
    <mirrorOf>*</mirrorOf>
    <name>阿里云公共仓库</name>
    <url>https://maven.aliyun.com/repository/public</url>
</mirror>

12.3 启动时报类找不到

检查是否添加了正确依赖
执行 mvn clean install
检查 IDE 是否正确导入了所有依赖

12.4 热部署不工作

确保正确配置了 DevTools
检查 IDE 自动构建设置
尝试手动触发构建 (Ctrl+F9 in IntelliJ)

通过以上完整指南，您应该能够成功安装和配置 Spring Boot 开发环境，并开始构建您的应用程序。

本文章首发在 LearnKu.com 网站上。

Markdown 文本

唐章明

课程读者 247 声望

装逼犯 @ 天天爱装逼

创造是最快乐的事

安装

推荐文章：

社区赞助商

关于 LearnKu

资源推荐

服务提供商

其他信息

安装