pom 里其实只写了两行坐标#

上一篇创建工程时只勾了一个 Spring Web，生成的 pom.xml 里的依赖部分也只有两项（课程源码 springboot-web-quickstart/pom.xml）：

1
<dependencies>
2
    <dependency>
3
        <groupId>org.springframework.boot</groupId>
4
        <artifactId>spring-boot-starter-web</artifactId>
5
    </dependency>
6

7
    <dependency>
8
        <groupId>org.springframework.boot</groupId>
9
        <artifactId>spring-boot-starter-test</artifactId>
10
        <scope>test</scope>
11
    </dependency>
12
</dependencies>

但工程里明明能用到 @RestController、@RequestMapping（Spring MVC）、能返回 JSON（Jackson）、能跑 @SpringBootTest 测试（JUnit）——这些东西的 jar 都是从哪来的？ PPT 第 16 页给的答案就是”起步依赖”：

起步依赖：

• spring-boot-starter-web：包含了 web 应用开发所需要的常见依赖。
• spring-boot-starter-test：包含了单元测试所需要的常见依赖。

PPT 第 16 页还给了官方 starter 的完整清单（想看还有哪些 starter、某个 starter 包含什么，就查这份文档）：

1
https://docs.spring.io/spring-boot/docs/3.1.3/reference/htmlsingle/#using.build-systems.starters

一句话概括：起步依赖（starter）是”打包好的依赖套餐”——写一行坐标，Maven 顺着它的传递性依赖把整套 jar 都拉下来，这正是 SpringBoot “简化配置、快速开发”的落点之一。

实测：这两行坐标到底带回来了多少东西#

在 IDEA 的 Maven 面板里展开 Dependencies 就能看到（PPT 第 16 页的截图）：

更完整的清单可以命令行打出来（mvn dependency:tree）。本机实测：

1
com.itheima:springboot-web-quickstart:jar:0.0.1-SNAPSHOT
2
+- org.springframework.boot:spring-boot-starter-web:jar:3.2.8:compile
3
|  +- org.springframework.boot:spring-boot-starter:jar:3.2.8
4
|  +- org.springframework.boot:spring-boot-starter-json:jar:3.2.8        → jackson 三件套
5
|  +- org.springframework.boot:spring-boot-starter-tomcat:jar:3.2.8      → tomcat-embed-core 10.1.26
6
|  +- org.springframework:spring-web:jar:6.1.11
7
|  \- org.springframework:spring-webmvc:jar:6.1.11
8
\- org.springframework.boot:spring-boot-starter-test:jar:3.2.8:test      → junit-jupiter 5.10.3 / mockito / assertj

实测：启动日志里看得见 Tomcat#

上一节证明”Tomcat 在依赖里”，这一节证明”Tomcat 真的被启起来了”。本机启动工程的真实日志：

1
  .   ____          _            __ _ _
2
 /\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \
3
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
4
 \\/  ___)| |_)| | | | | || (_| |  ) ) ) )
5
  '  |____| .__|_| |_|_| |_\__, | / / / /
6
 =========|_|==============|___/=/_/_/_/
7
 :: Spring Boot ::                (v3.2.8)
8

9
Starting SpringbootWebQuickstartApplication v0.0.1-SNAPSHOT using Java 17.0.3.1 with PID 43400
10
No active profile set, falling back to 1 default profile: "default"
11
Tomcat initialized with port 8080 (http)
12
Starting service [Tomcat]
13
Starting Servlet engine: [Apache Tomcat/10.1.26]
14
Initializing Spring embedded WebApplicationContext
15
Root WebApplicationContext: initialization completed in 993 ms
16
Tomcat started on port 8080 (http) with context path ''
17
Started SpringbootWebQuickstartApplication in 1.803 seconds (process running for 2.243)

1
Initializing Spring DispatcherServlet 'dispatcherServlet'
2
Initializing Servlet 'dispatcherServlet'
3
Completed initialization in 1 ms
4
Hello Controller ... hello ： Heima

启动日志怎么读（逐行对照）#

一、知识回顾（读完直接做下面的实践题）#

1. 起步依赖：spring-boot-starter-web 包含了 web 应用开发所需要的常见依赖；spring-boot-starter-test 包含了单元测试所需要的常见依赖——写一行坐标，等于引入一整套 jar（传递性依赖）
2. starter-web 里有什么（本机实测）：spring-boot-starter（spring-boot、spring-boot-autoconfigure、日志 logback、snakeyaml）、spring-boot-starter-json（jackson 系列）、spring-boot-starter-tomcat（tomcat-embed-core 10.1.26）、spring-web 6.1.11、spring-webmvc 6.1.11
3. starter-test 里有什么：spring-boot-test、junit-jupiter 5.10.3、mockito、assertj、json-path、spring-test、xmlunit 等，范围是 test（所以主程序用不到、也不参与打包）
4. 查看依赖的方式：IDEA 的 Maven 面板展开 Dependencies，或命令行 mvn dependency:tree；官方 starter 清单查 PPT 第 16 页给的文档（docs.spring.io 的 Spring Boot reference 里 using.build-systems.starters 一节）
5. starter 命名规律：官方是 spring-boot-starter-xxx，第三方是 xxx-spring-boot-starter
6. 内嵌 Tomcat 的含义：Tomcat 以 jar 依赖的形式跟着工程下载（tomcat-embed-core），启动时由 SpringApplication.run(...) 创建并启动——不需要单独安装 Tomcat、不需要部署 war，一个 main 方法就能跑起来
7. 启动日志关键行：Tomcat initialized with port 8080 (http)（端口）→ Starting Servlet engine: [Apache Tomcat/10.1.26]（Tomcat 版本）→ Tomcat started on port 8080 (http) with context path ''（开始监听、没有项目前缀）→ Started XxxApplication in N seconds（启动成功）
8. context path 为空的意思：访问地址是 http://localhost:8080/hello，地址里不带工程名（传统 war 部署到独立 Tomcat 时，地址里通常要带 /项目名）
9. 常见的启动失败：端口被占用会报 Port 8080 was already in use，先释放 8080 再启动
10. 工程目录：pom.xml（Maven 配置与起步依赖）、src/main/java（启动类 XxxApplication + 请求处理类）、src/main/resources（application.properties 等配置与资源）、src/test/java（测试类 XxxApplicationTests）

二、概念自测#

• 2-1 为什么一个 main 方法就能把 Web 应用跑起来？ 请从”依赖”和”服务器”两个方面回答，并说出这件事替我们省掉了哪些传统步骤。

  提示（先自己想，实在想不出再点开）

  一级 · 思路：这件事要拆成”东西从哪来”（依赖）和”谁来跑”（服务器）两条线 二级 · 方法：翻回前面”起步依赖”和”内嵌 Tomcat”两节，各找一句话 三级 · 骨架：① 依赖：pom 里只写 ＿＿ 一行坐标，它带回一整套 jar；② 服务器：Tomcat 以 ＿＿ 的形式存在，由 ＿＿ 创建并启动

  参考答案（做完再点开）

  两个方面： ① 依赖方面——起步依赖：pom.xml 里只写了 spring-boot-starter-web 一行坐标，它往下带回了 Web 开发所需要的常见依赖（spring-webmvc、jackson、日志，以及 spring-boot-starter-tomcat），不需要我们一个个去找 jar 坐标； ② 服务器方面——内嵌 Tomcat：Tomcat 作为 jar（tomcat-embed-core）跟着依赖一起下载，运行启动类时 SpringApplication.run(...) 把它创建并启动，日志里能看到 Tomcat started on port 8080 (http) with context path ''。 省掉的步骤：不用下载安装独立 Tomcat、不用配置 Tomcat、不用把工程打成 war 包丢进 webapps 部署——直接运行 main 即可，打出来的是可执行 jar（java -jar 就能起）。

• 2-2 pom 里只有两行依赖坐标，工程里为什么能用 Spring MVC、能返回 JSON、能写 @SpringBootTest 测试？ 解释”起步依赖”与”传递性依赖”在其中的作用，并说出这两行坐标分别对应哪套能力。

  提示（先自己想，实在想不出再点开）

  一级 · 思路：一行坐标能用一堆东西，说明这行坐标是”套餐”而不是单个 jar 二级 · 方法：看依赖树里 starter-web / starter-test 下面分别挂了什么 三级 · 骨架：starter-web → ＿＿（请求处理）+ ＿＿（JSON）+ ＿＿（内嵌服务器）；starter-test → ＿＿ 等测试件

  参考答案（做完再点开）

  因为 starter 是”依赖套餐”：spring-boot-starter-web 往下带了 spring-web + spring-webmvc（@RestController、@RequestMapping 来自这里）、spring-boot-starter-json（Jackson，把对象/集合转成 JSON）、spring-boot-starter-tomcat（内嵌服务器）等；spring-boot-starter-test 往下带了 junit-jupiter、mockito、assertj、spring-test（@SpringBootTest 来自这里）。 Maven 会把”依赖的依赖”一起解析进来，这就是传递性依赖（26 篇）。所以写一行 starter 坐标 = 引入一整套配套 jar，这正是 SpringBoot”简化配置、快速开发”的体现。

• 2-3 依赖树里 spring-boot-starter-test 后面为什么跟着 :test？这对主程序有什么影响？ 结合本机实测的那行 \- org.springframework.boot:spring-boot-starter-test:jar:3.2.8:test 回答。

  提示（先自己想，实在想不出再点开）

  一级 · 思路：冒号分隔的最后一段就是”范围” 二级 · 方法：对照 29 篇的依赖范围表，看 test 范围的三条效果（编译/打包/运行时） 三级 · 骨架：:test = ＿＿ 范围 → 主程序引用会 ＿＿，打包时 ＿＿

  参考答案（做完再点开）

  那一段就是依赖范围（scope）：starter-test 在 pom 里写了 <scope>test</scope>，所以依赖树里显示 :test。 影响：它是测试程序范围才有效的依赖——src/main/java 里的主程序引用不到它（引用会编译失败），打包运行时也不会带上它（junit、mockito 这些只在写测试时有用，没有必要上生产）。这正好和 29 篇里 junit 那条规则一致：测试框架的依赖要限制在测试范围。

• 2-4 启动日志里 context path '' 是什么意思？它决定了什么？ 再顺带说出：日志里端口信息是哪一行、哪一行代表”可以访问了”。

  提示（先自己想，实在想不出再点开）

  一级 · 思路：context path 就是 URL 里”工程名前缀”那一段 二级 · 方法：对比传统 war 部署到独立 Tomcat 时的访问地址 三级 · 骨架：'' 表示部署在 ＿＿，所以地址是 http://localhost:8080/＿＿（不带 ＿＿）；端口在 ＿＿ 行，成功标志是 ＿＿ 行

  参考答案（做完再点开）

  context path '' 表示应用部署在根路径上（没有项目名前缀），所以访问接口的地址是 http://localhost:8080/hello，地址里不带工程名；如果 context path 不是空的，就要写成 http://localhost:8080/项目名/hello。 相关日志行：端口信息在 Tomcat initialized with port 8080 (http)（以及后面的 Tomcat started on port 8080 (http)）；“可以访问了”的标志是 Started XxxApplication in N seconds，也可以直接看 Tomcat started on port 8080 那一行。

• 2-5 工程里的 src/main/java、src/main/resources、src/test/java 各放什么？ 启动类和请求处理类分别放在哪里、为什么？

  提示（先自己想，实在想不出再点开）

  一级 · 思路：三条路径按”代码还是资源""主程序还是测试”来分 二级 · 方法：看真实工程的目录树（本机实测的工程结构） 三级 · 骨架：java → ＿＿ 与 ＿＿；resources → ＿＿ 与 ＿＿；test/java → ＿＿

  参考答案（做完再点开）

  src/main/java 放主程序代码：启动类 SpringbootWebQuickstartApplication（带 @SpringBootApplication，类里有 main 方法）和请求处理类 HelloController（本课都放在 com.itheima 包下）； src/main/resources 放配置文件与资源文件：工程生成时自带 application.properties，后面的用户数据文件、前端静态页面也会放在这里； src/test/java 放测试代码：生成时自带 SpringbootWebQuickstartApplicationTests（@SpringBootTest + @Test），跑它相当于验证工程能否正常启动。 启动类之所以要放在工程里、且带着 main，是因为它就是我们”运行”的入口——所有启动动作都由那一行 SpringApplication.run(...) 触发。

三、综合题#

• 3-1 读一份陌生的启动日志与依赖树，判断工程状态 拿到一台机器上的工程（看不到代码），只有下面两份材料。请依次回答 6 个问题：

  1. 这个工程用的是哪个版本的 Spring Boot？从哪一行看出来的？
  2. 内嵌的 Tomcat 是什么版本？端口是多少？分别是哪一行？
  3. 它启动成功了吗？访问接口的地址前缀应该是 http://localhost:8080/xxx 还是 http://localhost:8080/工程名/xxx？依据是哪一行？
  4. pom 里至少写了哪些起步依赖？（结合依赖树回答）
  5. 工程里能写 @RestController 吗？能返回 JSON 吗？分别是谁带进来的依赖？
  6. 如果把 spring-boot-starter-test 从 pom 里删掉，工程主程序还能不能正常启动？（说明理由）

  材料一：依赖树（节选）

  1
  com.itheima:springboot-web-quickstart:jar:0.0.1-SNAPSHOT
  2
  +- org.springframework.boot:spring-boot-starter-web:jar:3.2.8:compile
  3
  |  +- org.springframework.boot:spring-boot-starter:jar:3.2.8
  4
  |  +- org.springframework.boot:spring-boot-starter-json:jar:3.2.8
  5
  |  +- org.springframework.boot:spring-boot-starter-tomcat:jar:3.2.8
  6
  |  +- org.springframework:spring-web:jar:6.1.11
  7
  |  \- org.springframework:spring-webmvc:jar:6.1.11
  8
  \- org.springframework.boot:spring-boot-starter-test:jar:3.2.8:test

  材料二：启动日志（节选）

  1
   :: Spring Boot ::                (v3.2.8)
  2
  Starting SpringbootWebQuickstartApplication v0.0.1-SNAPSHOT using Java 17.0.3.1 with PID 43400
  3
  Tomcat initialized with port 8080 (http)
  4
  Starting Servlet engine: [Apache Tomcat/10.1.26]
  5
  Tomcat started on port 8080 (http) with context path ''
  6
  Started SpringbootWebQuickstartApplication in 1.803 seconds (process running for 2.243)

  涉及知识点

  知识点	在这里的应用
  起步依赖	从依赖树反推 pom 里写了什么
  starter 的组成	-json → Jackson；-tomcat → 内嵌服务器；spring-webmvc → 请求处理注解
  内嵌 Tomcat	日志里的 Tomcat initialized / Started 是内嵌服务器的证据
  依赖范围	:test 的含义（只测试程序有效）
  启动日志	版本、端口、context path、启动成功的判断

  提示（先自己想，实在想不出再点开）

  一级 · 思路：日志给”服务器状态”，依赖树给”装了哪些零件”，两条线互相印证——版本看括号里的数字，服务器看 Tomcat 那几行，能不能跑看最后一行 二级 · 方法：:: Spring Boot :: (v3.2.8) 看 Spring Boot 版本；Starting Servlet engine: [Apache Tomcat/10.1.26] 看 Tomcat 版本；context path '' 说明地址不带工程名；:test 说明该依赖只在测试范围有效 三级 · 骨架：① 版本 = banner 里的 v____；② 端口 = Tomcat initialized with port ____；③ 成功标志 = Started ____ in ____ seconds

  参考答案（做完再点开）

  1. Spring Boot 3.2.8——banner 那行 :: Spring Boot :: (v3.2.8)；依赖树里各 starter 的 :3.2.8 也一致。
  2. Tomcat 10.1.26（Starting Servlet engine: [Apache Tomcat/10.1.26]），端口 8080（Tomcat initialized with port 8080 (http)，后面 Tomcat started on port 8080 (http) 再次确认）。
  3. 启动成功了（Started SpringbootWebQuickstartApplication in 1.803 seconds）。地址前缀是 http://localhost:8080/xxx——依据是 context path ''，表示没有项目名前缀。
  4. pom 里至少写了两个 starter：spring-boot-starter-web 和 spring-boot-starter-test（依赖树的一级子节点就这两条；父工程 spring-boot-starter-parent 也在 pom 里，但它不出现在依赖树里）。
  5. 都能。@RestController / @RequestMapping 来自 spring-webmvc（随 spring-boot-starter-web 带进来）；返回 JSON 靠 spring-boot-starter-json 里的 Jackson（jackson-databind 等）。
  6. 主程序照样能正常启动，因为 spring-boot-starter-test 的范围是 test（依赖树末尾的 :test），它只在测试程序范围内有效——主程序不需要它、打包运行时也不会带上它。受影响的只有 src/test/java 里的测试类（@SpringBootTest、@Test 会找不到类而编译报错）。这也顺手解释了 PPT 第 16 页为什么把它单独列出来：Web 开发和单元测试用的依赖是两套，各有个 starter。