手把手教你创建Spring Boot项目

原创于 2025-06-13 16:06:34 发布 · 1.1k 阅读

23 ·

CC 4.0 BY-SA版权

文章标签：

#spring boot #java #后端 #spring

创建 Spring Boot 项目的详细步骤

准备工作

安装 JDK
- 下载并安装 JDK 11 或更高版本（推荐 JDK 17）
- 验证安装：
```
java -version
javac -version
```
安装 IDE（可选但推荐）
- IntelliJ IDEA（推荐）
- Eclipse with STS 插件
- VS Code 配合 Spring Boot 扩展
安装 Maven（可选）
- 如果不想使用 IDE 内建的 Maven 功能，可以单独安装：
```
mvn -v
```

创建 Spring Boot 项目

方法一：使用 Spring Initializr（推荐）

通过网站创建
- 访问 start.spring.io
- 填写项目信息：
  - Project: Maven Project（或 Gradle）
  - Language: Java
  - Spring Boot: 选择最新稳定版（如 3.2.x）
  - Group: 通常使用公司域名反写（如 com.example）
  - Artifact: 项目名称（如 demo）
  - Packaging: Jar（推荐）
  - Java: 选择与安装的 JDK 匹配的版本（如 17）
添加依赖
- 根据需求添加依赖，例如：
  - Spring Web（构建 Web 应用）
  - Spring Data JPA（数据库访问）
  - Lombok（简化代码）
  - Thymeleaf（模板引擎）
生成并下载项目
- 点击 “Generate” 按钮下载压缩包
- 解压后导入到 IDE 中

方法二：使用 IDE 创建（以 IntelliJ IDEA 为例）

新建项目
- 选择 “File” > “New” > “Project”
- 选择 “Spring Initializr”
配置项目
- 填写与网站相同的项目信息
- 选择依赖项
- 点击 “Finish” 完成创建

方法三：使用命令行

使用 curl 命令

curl https://start.spring.io/starter.zip -d dependencies=web,lombok -d javaVersion=17 -d type=maven-project -d baseDir=myproject -o myproject.zip

解压并导入
```
unzip myproject.zip
```

项目结构说明

典型的 Spring Boot 项目结构：

myproject/
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── com/example/demo/
│   │   │       ├── DemoApplication.java    # 主启动类
│   │   │       ├── controller/            # 控制器
│   │   │       ├── service/               # 业务服务
│   │   │       ├── repository/            # 数据访问
│   │   │       └── model/                 # 实体类
│   │   └── resources/
│   │       ├── static/                    # 静态资源
│   │       ├── templates/                 # 模板文件
│   │       ├── application.properties     # 配置文件
│   │       └── application.yml           # 或 YAML 配置
│   └── test/                             # 测试代码
├── target/                               # 构建输出
├── pom.xml                               # Maven 配置
└── mvnw                                  # Maven 包装器

运行项目

通过 IDE 运行
- 找到主类（如 DemoApplication）
- 右键选择 “Run” 或 “Debug”

通过命令行运行

mvn spring-boot:run

或

./mvnw spring-boot:run   # 使用包装器

构建可执行 JAR

mvn clean package

然后运行：

java -jar target/demo-0.0.1-SNAPSHOT.jar

常用配置

application.properties 示例

server.port=8081
spring.application.name=myapp
spring.datasource.url=jdbc:mysql://localhost:3306/mydb
spring.datasource.username=root
spring.datasource.password=123456
spring.jpa.hibernate.ddl-auto=update

或使用 application.yml

server:
  port: 8081
spring:
  application:
    name: myapp
  datasource:
    url: jdbc:mysql://localhost:3306/mydb
    username: root
    password: 123456
  jpa:
    hibernate:
      ddl-auto: update

创建简单的 REST 控制器

创建 Controller 类

package com.example.demo.controller;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("/api")
public class DemoController {
    
    @GetMapping("/hello")
    public String sayHello() {
        return "Hello, Spring Boot!";
    }
}

访问测试
- 启动应用后访问：http://localhost:8080/api/hello

添加常用依赖

在 pom.xml 中添加：

Lombok（减少样板代码）

<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <optional>true</optional>
</dependency>

Spring Data JPA（数据库访问）

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <scope>runtime</scope>
</dependency>

Validation（参数校验）

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

注意事项

确保 JDK 版本与项目配置一致
开发时可以使用 Spring Boot DevTools 实现热部署
生产环境建议使用外部配置文件（如 application-prod.yml）
遵循 RESTful 设计原则创建 API
为生产环境配置适当的日志系统（如 Logback）

至此，我们就成功创建了一个Spring Boot项目！