Java 后端 / 系统课时

创建并运行首个项目

创建并运行首个项目

本课从一个最小 Maven 工程开始,完成 Spring Boot 3 应用的创建、启动与 HTTP 验证,并借助目录、启动类、依赖配置和日志建立对标准工程结构的整体认识。

学习目标

  • 搭建可运行的 Spring Boot 3 Maven 工程
  • 说明启动类、依赖和配置文件各自承担的职责
  • 根据启动日志和接口响应判断应用是否正常

准备开发环境

示例使用 Java 17 和 Maven。先确认命令行能够找到 JDK 与 Maven;版本号中的补丁位可能因本机安装而不同。

bash
java -version
mvn -version

预期输出

text
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 负责依赖与构建。

text
first-app/
├── pom.xml
└── src/
    └── main/
        ├── java/
        │   └── com/example/firstapp/
        │       └── FirstAppApplication.java
        └── resources/
            └── application.yml

在 pom.xml 中声明 Spring Boot 父工程、Web Starter 和构建插件。父工程统一管理常用依赖版本,因此 Starter 通常不需要单独填写版本。

xml
<?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。

java
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 使用缩进表示层级,不能用制表符代替空格。

yaml
spring:
  application:
    name: first-app

server:
  port: 8080

启动类、依赖和配置文件会在运行时形成一条清晰链路:Maven 提供类路径,启动类创建应用上下文,自动配置装配 Web 组件,配置文件覆盖默认参数。

Spring Boot 首个项目的文件与启动关系

启动并验证

在项目根目录执行 Maven 启动命令。首次运行需要下载依赖,耗时会明显长于后续启动。

bash
mvn spring-boot:run

预期输出

text
Tomcat started on port 8080 (http)
Started FirstAppApplication in <TIME> seconds

保持应用运行,再打开另一个终端请求接口。

bash
curl http://localhost:8080/hello

预期输出

json
{"message":"Spring Boot 3 is running"}

日志中的线程名、进程号、启动耗时和部分版本信息会随环境变化;判断成功时重点查看端口监听信息、Started FirstAppApplication 和接口响应。

处理典型失败

出现 UnsupportedClassVersionError 时,通常是编译和运行所用 JDK 不一致,应重新检查 java -version、mvn -version 中显示的 Java 路径。

出现端口占用时,可结束占用进程,或把 server.port 改为未使用端口,并同步修改验证 URL。接口返回 404 时,重点检查访问路径、@GetMapping 值以及启动类是否位于控制器包的上层。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

创建并运行首个项目

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通