Java 后端 / 系统课时
创建并运行首个项目
创建并运行首个项目
本课从一个最小 Maven 工程开始,完成 Spring Boot 3 应用的创建、启动与 HTTP 验证,并借助目录、启动类、依赖配置和日志建立对标准工程结构的整体认识。
学习目标
- 搭建可运行的 Spring Boot 3 Maven 工程
- 说明启动类、依赖和配置文件各自承担的职责
- 根据启动日志和接口响应判断应用是否正常
准备开发环境
示例使用 Java 17 和 Maven。先确认命令行能够找到 JDK 与 Maven;版本号中的补丁位可能因本机安装而不同。
java -version
mvn -version预期输出
openjdk version "17.<PATCH>"
Apache Maven 3.<MINOR>.<PATCH>若提示命令不存在,应先修正 JAVA_HOME、PATH 或 Maven 安装,再继续创建项目。Spring Boot 3 工程不要使用低于 Java 17 的运行环境。
建立标准工程
创建目录后,将文件组织成下面的结构。src/main/java 保存业务代码,src/main/resources 保存配置,pom.xml 负责依赖与构建。
first-app/
├── pom.xml
└── src/
└── main/
├── java/
│ └── com/example/firstapp/
│ └── FirstAppApplication.java
└── resources/
└── application.yml在 pom.xml 中声明 Spring Boot 父工程、Web Starter 和构建插件。父工程统一管理常用依赖版本,因此 Starter 通常不需要单独填写版本。
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>3.3.13</version>
<relativePath/>
</parent>
<groupId>com.example</groupId>
<artifactId>first-app</artifactId>
<version>0.0.1-SNAPSHOT</version>
<name>first-app</name>
<properties>
<java.version>17</java.version>
</properties>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
</project>该配置生效后,Maven 会引入 Web 应用所需的 Spring MVC、JSON 序列化和内嵌服务器组件,并允许使用 spring-boot:run 启动应用。
编写启动类与配置
启动类必须位于业务包的上层位置,便于默认组件扫描覆盖其子包。@SpringBootApplication 组合了配置、自动配置和组件扫描能力;main 方法把控制权交给 Spring Boot。
package com.example.firstapp;
import java.util.Map;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
@SpringBootApplication
@RestController
public class FirstAppApplication {
public static void main(String[] args) {
SpringApplication.run(FirstAppApplication.class, args);
}
@GetMapping("/hello")
public Map<String, String> hello() {
return Map.of("message", "Spring Boot 3 is running");
}
}在 application.yml 中设置应用名与端口。YAML 使用缩进表示层级,不能用制表符代替空格。
spring:
application:
name: first-app
server:
port: 8080启动类、依赖和配置文件会在运行时形成一条清晰链路:Maven 提供类路径,启动类创建应用上下文,自动配置装配 Web 组件,配置文件覆盖默认参数。

启动并验证
在项目根目录执行 Maven 启动命令。首次运行需要下载依赖,耗时会明显长于后续启动。
mvn spring-boot:run预期输出
Tomcat started on port 8080 (http)
Started FirstAppApplication in <TIME> seconds保持应用运行,再打开另一个终端请求接口。
curl http://localhost:8080/hello预期输出
{"message":"Spring Boot 3 is running"}日志中的线程名、进程号、启动耗时和部分版本信息会随环境变化;判断成功时重点查看端口监听信息、Started FirstAppApplication 和接口响应。
处理典型失败
出现 UnsupportedClassVersionError 时,通常是编译和运行所用 JDK 不一致,应重新检查 java -version、mvn -version 中显示的 Java 路径。
出现端口占用时,可结束占用进程,或把 server.port 改为未使用端口,并同步修改验证 URL。接口返回 404 时,重点检查访问路径、@GetMapping 值以及启动类是否位于控制器包的上层。