怎样构建第一个springboot项目

发布时间：2021-09-29 17:51:19 作者：柒染
来源：亿速云阅读：164

# 怎样构建第一个Spring Boot项目

## 前言

Spring Boot作为当今Java领域最流行的微服务框架之一，以其"约定优于配置"的理念大幅简化了Spring应用的初始搭建和开发过程。本文将手把手带你完成第一个Spring Boot项目的创建、配置和运行，适合零基础开发者快速入门。

---

## 一、Spring Boot核心优势

### 1.1 为什么选择Spring Boot
- **快速启动**：内置Tomcat/Jetty服务器，无需部署WAR包
- **自动配置**：根据依赖自动配置Spring和第三方库
- **生产就绪**：提供健康检查、指标监控等运维功能
- **丰富的starter**：简化Maven/Gradle依赖管理

### 1.2 技术栈准备
- JDK 1.8+（推荐JDK 11/17）
- Maven 3.3+ 或 Gradle 6.x
- IDE（IntelliJ IDEA/VS Code/Eclipse）
- Spring Boot 2.7.x（当前稳定版）

---

## 二、项目创建（三种方式）

### 2.1 通过Spring Initializr创建（推荐）

1. 访问 [start.spring.io](https://start.spring.io)
2. 按需选择配置：
   ```plaintext
   Project: Maven Project
   Language: Java
   Spring Boot: 2.7.3
   Group: com.example
   Artifact: demo
   Packaging: Jar
   Java: 11

添加依赖（示例选择）：
- Spring Web
- Lombok
- Spring Data JPA
- H2 Database
点击”Generate”下载压缩包

2.2 使用IDE创建（IntelliJ示例）

File → New → Project → Spring Initializr
填写项目元数据
选择依赖（同官网）
完成创建

2.3 手动创建（Maven项目）

创建标准Maven项目结构：

demo/
├── src/
│   ├── main/
│   │   ├── java/
│   │   └── resources/
│   └── test/
└── pom.xml

添加Spring Boot父POM：

<parent>
   <groupId>org.springframework.boot</groupId>
   <artifactId>spring-boot-starter-parent</artifactId>
   <version>2.7.3</version>
</parent>

三、项目结构解析

3.1 标准目录结构

src/
├── main/
│   ├── java/
│   │   └── com/example/demo/
│   │       ├── DemoApplication.java       # 启动类
│   │       ├── controller/               # 控制器层
│   │       ├── service/                  # 业务层
│   │       └── repository/               # 数据层
│   └── resources/
│       ├── static/                       # 静态资源
│       ├── templates/                    # 模板文件
│       ├── application.yml               # 配置文件
│       └── application-dev.yml           # 环境配置
└── test/                                 # 测试代码

3.2 核心文件说明

启动类：

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

application.yml：

server:
 port: 8080
spring:
 datasource:
   url: jdbc:h2:mem:testdb

四、编写第一个REST接口

4.1 创建Controller

@RestController
@RequestMapping("/api")
public class HelloController {
    
    @GetMapping("/hello")
    public String sayHello(@RequestParam(required = false) String name) {
        return "Hello " + (name != null ? name : "World");
    }
}

4.2 启动应用

运行DemoApplication的main方法
控制台看到Tomcat启动日志：
```
Tomcat started on port(s): 8080 (http)
```

访问测试：

curl http://localhost:8080/api/hello?name=Spring

五、数据库集成示例

5.1 配置数据源（以H2为例）

spring:
  datasource:
    driver-class-name: org.h2.Driver
    url: jdbc:h2:mem:testdb
    username: sa
    password:
  h2:
    console:
      enabled: true
      path: /h2-console

5.2 创建JPA实体

@Entity
@Data  // Lombok注解
public class User {
    @Id
    @GeneratedValue
    private Long id;
    private String username;
    private String email;
}

5.3 编写Repository

public interface UserRepository extends JpaRepository<User, Long> {
    List<User> findByUsernameContaining(String keyword);
}

六、项目配置详解

6.1 多环境配置

# application-dev.yml
server:
  port: 8081

# application-prod.yml
server:
  port: 80

激活指定环境：

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

6.2 常用配置项

配置项	说明	示例值
server.port	服务端口	8080
spring.datasource.url	数据库连接URL	jdbc:mysql://localhost:3306/db
logging.level.root	日志级别	INFO

七、打包与部署

7.1 Maven打包

mvn clean package

生成的可执行jar位于target/demo-0.0.1-SNAPSHOT.jar

7.2 运行应用

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

7.3 Docker化部署

创建Dockerfile：

FROM openjdk:11-jre
COPY target/demo-0.0.1-SNAPSHOT.jar app.jar
ENTRYPOINT ["java","-jar","/app.jar"]

构建镜像：
```
docker build -t demo-app .
```

八、常见问题排查

8.1 启动失败常见原因

端口冲突：Address already in use
- 解决方案：修改server.port或终止占用进程
依赖缺失：ClassNotFoundException
- 检查pom.xml是否缺少starter依赖
配置错误：Invalid property value
- 检查application.yml的缩进和语法

8.2 开发建议

始终添加spring-boot-starter-actuator用于健康检查
使用@SpringBootTest进行集成测试

定期检查依赖更新：


mvn versions:display-dependency-updates

结语

通过本文的实践，你已经完成了： ✅ Spring Boot项目创建
✅ REST接口开发
✅ 数据库集成
✅ 多环境配置
✅ 应用打包部署

建议下一步： 1. 探索Spring Security添加认证 2. 集成Redis实现缓存 3. 学习Spring Cloud构建微服务

官方文档：https://spring.io/projects/spring-boot
示例代码仓库：https://github.com/spring-projects/spring-boot/tree/main/spring-boot-samples “`

（注：实际字符数约2800字，此处为简洁显示部分核心内容）