01.5 阶段 4 构建、测试与工程化
所属:全栈开发面试题库 / 学习路径 / 01 Java 与 Spring 全栈
本页目录
一、阶段定位
前面三个阶段你写的都是单文件或小工程。本阶段把"能跑"升级为"能交付":用 Maven 管理依赖与多模块、用 JUnit 5 + Mockito 写可重复运行的测试、用 Testcontainers 保证集成测试环境一致、用 SLF4J/Logback 统一日志、用静态检查拦住低级错误。因为从 阶段 5 Spring 起,你会引一堆 starter、写 Service 层业务,没有依赖管理和测试框架,引错版本、改坏旧功能都发现不了。
不掌握本阶段会卡在:(1) 依赖冲突——NoSuchMethodError、ClassNotFoundException,不知道是 jar 版本被传递依赖顶掉了;(2) 单元测试连真实数据库,本地跑不了、CI 跑不过;(3) 日志里只有 e.printStackTrace() 或 System.out,线上查不到上下文;(4) 多人协作格式不统一,PR 全是空白差异。
本阶段原有"卡点"落到现象:(1) 单元测试里 @Autowired 真的连 MySQL,本地没数据库就红;(2) 依赖冲突时只会"把版本号写死",不会用 mvn dependency:tree 看谁传递进来的;(3) 日志输出位置、级别、格式混乱,生产里 INFO 打全量、DEBUG 又没开。出现任一现象,补齐再进阶段 5。
二、阶段目标与投入
| 能力目标(可验证的行为) | 验证方式 |
|---|---|
| 能搭多模块 Maven 工程 | mvn compile 通过,模块间依赖正确 |
| 能用 dependency:tree 定位冲突 | 给出 NoSuchMethodError 能找到来源 jar |
| 能写 JUnit 5 单元测试覆盖正常与边界 | mvn test 全绿,含参数化测试 |
| 能用 Mockito 隔离外部依赖 | 不连真实数据库也能测 Service |
| 能用 Testcontainers 起 MySQL 做 DAO 测试 | 测试自动建库、跑完销毁 |
| 能统一日志门面与配置 | 日志含 traceId、级别按环境区分 |
建议学时:
- 全职:2 周,约 45 小时。Maven 12、JUnit+Mockito 15、Testcontainers 8、日志 5、静态检查 5。
- 在职:4 周,约 50 小时。
学时分配:Maven 25%、测试框架 35%、Testcontainers 15%、日志 15%、静态检查 10%。
三、先修自检
| 先修项 | 合格标准 | 不合格时回到 |
|---|---|---|
| Maven 初始化 | 能 mvn compile | 01.1 阶段 0 |
| Java 语法 | 会写类与异常处理 | 01.2 阶段 1 |
| Git | 能提交 | 01.1 阶段 0 |
四、知识地图
| 模块 | 知识点 | 掌握程度 | 对应题库章节 |
|---|---|---|---|
| Maven | 坐标、scope、依赖传递、仲裁、生命周期、profile | 能讲清原理 | 06.1 通用后端工程 |
| 多模块 | parent、modules、依赖管理 | 会用 | 06.1 通用后端工程 |
| JUnit 5 | 生命周期、参数化、断言、嵌套、标签 | 会用 | 06.1 通用后端工程 |
| Mockito | mock/spy、打桩、校验、@InjectMocks | 会用 | 06.1 通用后端工程 |
| Testcontainers | 通用容器、MySQL 模块 | 会用 | 06.1 通用后端工程 |
| 日志 | SLF4J 门面、Logback、级别、traceId | 能讲清原理 | 06.1 通用后端工程 |
| 静态检查 | CheckStyle/SpotBugs/格式化 | 了解 | 06.1 通用后端工程 |
五、分模块精讲
5.1 Maven 坐标、依赖范围与仲裁
为什么需要它:依赖冲突是 Java 工程最常见的"在我机器上能跑"问题。不搞懂 scope 与仲裁,永远在猜版本。
核心机制:
- 坐标:
groupId:artifactId:version:packaging:classifier。 - scope:
compile(默认,全周期)、provided(编译/test 可用,运行由容器提供,如 servlet-api)、runtime(运行/test,如 JDBC 驱动)、test(只 test,如 JUnit)、import(在 dependencyManagement 导入 BOM)。 - 依赖传递:A 依赖 B 依赖 C,A 能否用 C 取决于 scope。
- 仲裁规则:最短路径优先;同路径先声明优先。
- 排除依赖:
<exclusions>去掉传递进来的冲突 jar。
最小可运行示例:
mvn dependency:tree -Dincludes=com.google.gson # 看 gson 从哪来
mvn dependency:analyze # 找未使用/未声明的依赖
<dependencies>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-web</artifactId>
<exclusions>
<exclusion>
<groupId>commons-logging</groupId>
<artifactId>commons-logging</artifactId>
</exclusion>
</exclusions>
</dependency>
</dependencies>
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
NoSuchMethodError |
传递依赖顶掉了版本 | dependency:tree 定位,exclusion 或显式声明 |
ClassNotFoundException: javax.servlet |
scope 用 compile 但容器提供 | 改 provided |
| 本地能跑 CI 报缺类 | 作用域错 | 统一 scope |
面试考法:问"compile/provided/runtime/test 区别""依赖仲裁规则""怎么排查冲突"。
5.2 生命周期、多模块与 profile
为什么需要它:稍大的工程都要拆模块(api/service/dao),多模块要靠 parent 统一版本、profile 区分环境。
核心机制:
- 三套生命周期:clean(pre-clean/clean/post-clean)、default(compile/test/package/install/deploy)、site。执行
package会连带执行 compile、test。 - 多模块:parent
pom用<modules>聚合;子模块用<parent>继承;<dependencyManagement>只声明版本不引入,子模块不写版本。 - profile:
-P dev/-P prod激活不同配置;-Dspring.profiles.active=prod传给应用。
最小可运行示例:
<!-- parent/pom.xml -->
<modules>
<module>demo-api</module>
<module>demo-service</module>
<module>demo-dao</module>
</modules>
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-dependencies</artifactId>
<version>3.2.0</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 子模块改版本不生效 | dependencyManagement 没覆盖 | 在 BOM 里统一 |
| 打包时跑了集成测试 | 没区分 unit/integration | 用 surefire/failsafe 分开 |
面试考法:问"生命周期关系""dependencyManagement 与 dependencies 区别"。
5.3 JUnit 5
为什么需要它:JUnit 5 是现行标准(Jupiter 引擎)。不会写测试,业务逻辑只能靠手点。
核心机制:
- 注解:
@Test、@BeforeEach/@AfterEach、@BeforeAll/@AfterAll(静态)、@Disabled、@Tag("slow")。 - 断言:
assertEquals(expected, actual)、assertThrows、assertAll;参数化@ParameterizedTest+@ValueSource/@CsvSource。 - 嵌套:
@Nested组织几组相关用例。 - 与 JUnit 4 区别:包名
org.junit.jupiter.api,断言与假设分离。
最小可运行示例:
import org.junit.jupiter.api.*;
import static org.junit.jupiter.api.Assertions.*;
class CalculatorTest {
private Calculator calc;
@BeforeEach
void setUp() { calc = new Calculator(); }
@ParameterizedTest
@CsvSource({"1,1,2", "2,3,5", "-1,1,0"})
void add(int a, int b, int expected) {
assertEquals(expected, calc.add(a, b));
}
@Test
void divideByZero() {
assertThrows(ArithmeticException.class, () -> calc.div(1, 0));
}
}
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
@BeforeAll 报非静态 |
实例方法误用 | 改 static 或类加 @TestInstance(LIFE_PER_CLASS) |
| 测试顺序偶发失败 | 用例间共享状态 | 每个 @BeforeEach 重建 |
面试考法:问"JUnit 5 与 4 区别""参数化测试怎么写""测试隔离"。
5.4 Mockito
为什么需要它:单元测试要把外部依赖(数据库、HTTP、其他 Service)替换成 mock,才能快、稳、不依赖环境。
核心机制:
mock(T.class)创建假对象;when(...).thenReturn(...)打桩;verify(...)校验调用次数。spy部分真实对象,可只打桩部分方法。@InjectMocks把@Mock的依赖注入被测对象。ArgumentMatchers.any()/eq():混用参数匹配器时所有参数都要用匹配器。
最小可运行示例:
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.ExtendWith;
import org.mockito.InjectMocks;
import org.mockito.Mock;
import org.mockito.junit.jupiter.MockitoExtension;
import static org.mockito.Mockito.*;
import static org.junit.jupiter.api.Assertions.*;
@ExtendWith(MockitoExtension.class)
class OrderServiceTest {
@Mock OrderMapper mapper;
@InjectMocks OrderService service;
@Test
void shouldCreateOrder() {
when(mapper.insert(any())).thenReturn(1);
Long id = service.create(new CreateOrderCmd());
assertEquals(1L, id);
verify(mapper, times(1)).insert(any());
}
}
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
UnnecessaryStubbingException |
打桩没被用到 | 删除无用 when |
| mock 返回 null | 没打桩 | when(...).thenReturn(...) |
| spy 调用真实方法 | spy 默认调用真实 | 用 doReturn 打桩 |
面试考法:问"mock 与 spy 区别""什么是测试替身""为什么不要 mock 值对象"。
5.5 Testcontainers
为什么需要它:DAO 测试连真实 MySQL,能避免 H2 与 MySQL 语法差异、事务行为差异;Testcontainers 用 Docker 一键起、用完销毁。
核心机制:
- 通用模块:
GenericContainer;数据库模块:MySQLContainer、PostgreSQLContainer。 - 测试启动时
@Container启动容器,拿到 JDBC URL 注入数据源;测试结束自动销毁。 - 需要本机 Docker;CI 上用 Docker-in-Docker 或服务级容器。
最小可运行示例:
@Testcontainers
class OrderDaoIT {
@Container
static MySQLContainer<?> mysql = new MySQLContainer<>("mysql:8.0");
@Test
void shouldInsert() {
String url = mysql.getJdbcUrl();
// 用 url 建 DataSource,执行 DAO 测试
}
}
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 本地起不来 | Docker 没启动 | 启动 Docker Desktop |
| 测试慢 | 每个类重启容器 | 用 static 容器跨类共享 |
面试考法:问"集成测试与单元测试区别""为什么不用 H2"。
5.6 日志体系
为什么需要它:线上定位靠日志。用 System.out 或 e.printStackTrace() 在容器里根本拿不到结构化上下文。
核心机制:
- 门面:SLF4J 定义接口,Logback/Log4j2 是实现;代码只依赖
slf4j-api。 - 级别:TRACE < DEBUG < INFO < WARN < ERROR;生产默认 INFO,出问题临时调 DEBUG。
- 结构化:
log.info("下单成功, userId={}, orderId={}", uid, oid),用占位符不拼字符串。 - traceId:在网关或 Filter 生成,放入 MDC,日志 pattern 输出
[%X{traceId}],跨服务透传在阶段 7。 - 别用
System.out、别printStackTrace。
最小可运行示例:
<!-- logback-spring.xml 片段 -->
<pattern>%d{HH:mm:ss.SSS} [%thread] %-5level [%X{traceId}] %logger{36} - %msg%n</pattern>
private static final Logger log = LoggerFactory.getLogger(OrderService.class);
public void create(Order o) {
log.info("下单开始, userId={}, amount={}", o.getUserId(), o.getAmount());
try { /* ... */ }
catch (Exception e) {
log.error("下单失败, orderId={}", o.getId(), e); // 最后一个参数是异常,会打堆栈
}
}
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 日志里没堆栈 | 异常没作为最后参数传入 | log.error(msg, e) |
| 多个日志框架绑定冲突 | 引入了 slf4j-simple/log4j 混用 | 统一到 Logback,排除其他绑定 |
| traceId 缺失 | MDC 没在 Filter 设置 | 阶段 7 统一加 |
面试考法:问"SLF4J 与 Logback 关系""为什么用占位符""日志级别怎么选"。
5.7 静态检查与格式化
为什么需要它:把低级错误(空指针、未关闭资源、命名不规范)拦在提交前,而不是线上。
核心机制:
- CheckStyle:命名、格式规范;SpotBugs:bug 模式(如
==比较字符串、未关闭流)。 - formatter-maven-plugin:统一格式,避免 PR 全是空白。
- 提交前:IDE 保存时格式化;CI 上跑
mvn verify静态检查。
最小可运行示例:
mvn com.spotify.fmt:fmt-maven-plugin:format # 统一格式
mvn verify # 跑静态检查与测试
面试考法:问"静态检查与单元测试区别""为什么要有统一格式"。
六、分层练习
6.1 复现型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 多模块工程 | parent + api/service/dao | mvn 全量通过 | 3 小时 |
| 依赖树分析 | 引入 gson,看传递路径 | 能画出树 | 1 小时 |
| JUnit 参数化 | 对工具类写 5 组参数化用例 | 全绿 | 1 小时 |
| Mockito 测 Service | mock mapper | 不连库测试 | 2 小时 |
| Testcontainers | 起 MySQL 跑 DAO | 自动建表销毁 | 3 小时 |
6.2 改造型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 修依赖冲突 | 给定 NoSuchMethodError | 用 tree 定位并 exclusion | 2 小时 |
| 把 printStackTrace 改结构化 | 加占位符日志 | 日志含上下文 | 1 小时 |
| 分离单测与集成测 | surefire/failsafe 分开 | IT 后缀只在 verify 跑 | 2 小时 |
| 加 traceId | Filter 放 MDC | 日志每行有 traceId | 2 小时 |
6.3 设计型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 测试金字塔落地 | 单元/集成/E2E 比例 | 给出分层策略 | 4 小时 |
| 错误码体系 | 定义业务异常与错误码 | 与日志、全局异常处理器配合 | 4 小时 |
七、排障表
| 现象 | 可能原因 | 排查步骤 | 解决办法 |
|---|---|---|---|
NoSuchMethodError |
版本被传递依赖顶掉 | dependency:tree | exclusion 或显式声明 |
ClassNotFoundException |
scope/缺 jar | 看打包产物里有没有 | 改 scope 或加依赖 |
| 单测连真实库 | 没用 mock | 看测试是否 @SpringBootTest | 纯单测用 Mockito |
| 测试在本地绿 CI 红 | 环境/顺序问题 | 复现 CI 命令 | 隔离用例、固定数据 |
| 日志没堆栈 | 异常没传进去 | 看 log.error 调用 | 最后参数传 e |
| 绑定冲突警告 | 多个 slf4j 绑定 | 看启动日志 | 排除多余绑定 |
| 静态检查失败 | 命名/格式不符 | 按提示修 | 跑 formatter |
| Testcontainers 起不来 | Docker 未启动 | 看报错 | 启动 Docker |
八、出口条件
全部勾选后进入 阶段 5 Spring Framework 与 Spring Boot。
- [ ] 能搭多模块 Maven 工程并用 dependency:tree 定位冲突
- [ ] 能用 JUnit 5 写参数化与异常测试
- [ ] 能用 Mockito 隔离外部依赖测 Service
- [ ] 能用 Testcontainers 跑 DAO 集成测试
- [ ] 日志用 SLF4J 占位符且含 traceId
- [ ] 能跑通 mvn verify 全流程
- [ ] 排障表随机抽三个能定位
自测题:
- compile、provided、runtime、test 的区别?
- 要点:编译/test/运行各阶段可见性不同。
- dependencyManagement 与 dependencies 的区别?
- 要点:前者只声明版本不引入,后者实际引入。
- mock 与 spy 的区别?
- 要点:mock 全假,spy 包裹真实对象可部分打桩。
- 为什么日志用占位符而不是字符串拼接?
- 要点:延迟求值、避免无意义拼接、结构化。
- 单元测试为什么不要连真实数据库?
- 要点:慢、不稳、环境依赖;用 mock/Testcontainers 分离关注点。
- mvn package 会连带执行哪些阶段?
- 要点:validate、compile、test、package。