第一个应用：十几行代码背后的启动全流程

java -version
# java version "21.0.x" 即可

<?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.5.0</version> <!-- 用 3.5.x 系列最新补丁，以 start.spring.io 生成结果为准 -->
        <relativePath/>
    </parent>

    <groupId>com.example</groupId>
    <artifactId>first-app</artifactId>
    <version>0.0.1-SNAPSHOT</version>

    <properties>
        <java.version>21</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>

mvn spring-boot:run

Tomcat started on port 8080 (http) with context path '/'
Started FirstAppApplication in 1.834 seconds (process running for 2.456)

first-app/
  mvnw  mvnw.cmd                     Maven 包装器：没装 Maven 也能用 ./mvnw 启动
  pom.xml
  src/main/java/com/example/firstapp/
    FirstAppApplication.java         主类，整个应用的入口与坐标原点
  src/main/resources/
    application.properties           配置文件，可整体改名为 application.yml（本模块用 yml）
    static/                          静态资源目录
    templates/                       服务端模板目录，纯 API 项目用不到
  src/test/java/com/example/firstapp/
    FirstAppApplicationTests.java    测试目录与类名都是约定，170 篇展开

mvn dependency:tree

package com.example.firstapp;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class FirstAppApplication {

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

1  main 调用 SpringApplication.run(FirstAppApplication.class, args)
   把主类作为「配置源头」交给框架，方法返回的就是运行中的容器
2  推断应用类型
   类路径找得到 spring-webmvc 就是 Servlet Web 应用（响应式与普通应用另有分支），
   这个结论决定后面创建哪套容器、起哪款服务器
3  准备 Environment，随后打印启动横幅
   命令行参数、环境变量、application.yml 在这一步汇入配置环境，
   那头 ASCII 野牛也是在这里打的——所以横幅出现时配置已经就位
4  按第 2 步的结论创建 ApplicationContext
   本例拿到的是 AnnotationConfigServletWebServerApplicationContext
5  把主类注册为第一个 Bean 定义
   主类自己先进容器——它是后续扫描与自动配置的起点
6  组件扫描
   解析主类上的 @ComponentScan：主类所在包及子包下所有 @Component 系类登记为 Bean 定义
7  自动配置裁决
   @EnableAutoConfiguration 拉出候选清单，条件注解逐个裁决，
   幸存者补上数据源、JSON 转换器、Web 服务器工厂等基础设施 Bean 定义
8  实例化全部单例，启动内嵌 Tomcat，回调 Runner
   Bean 逐个就绪，Tomcat 绑定 8080，日志打出 Started ...，
   最后 ApplicationRunner / CommandLineRunner 里的启动逻辑执行

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

package com.example.firstapp.controller;

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

@RestController
public class HelloController {

    @GetMapping("/hello")
    public String hello() {
        return "hello, spring boot";
    }

    @GetMapping("/hello/{name}")
    public String greet(@PathVariable String name) {
        return "hello, " + name;
    }
}

curl -i http://localhost:8080/hello

HTTP/1.1 200
Content-Type: text/plain;charset=UTF-8
Content-Length: 18

hello, spring boot

curl -i http://localhost:8080/hello/fandex
hello, fandex

***************************
APPLICATION FAILED TO START
***************************

Description:

Web server failed to start. Port 8080 was already in use.

Action:

Identify and stop the process that's listening on port 8080 or configure this
application to listen on another port.

# Windows
netstat -ano | findstr :8080
taskkill /PID 12345 /F

# macOS 与 Linux
lsof -i :8080
kill -9 12345

com.example.firstapp                        主类在这里
com.example.firstapp.web.HelloController    能扫到：主类包的子包
com.example.other.ThirdController           扫不到：不在主类包及子包