罗罗编程学习记录
本页内容 展开查看

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 全流程
  • [ ] 排障表随机抽三个能定位

自测题:

  1. compile、provided、runtime、test 的区别?
    • 要点:编译/test/运行各阶段可见性不同。
  2. dependencyManagement 与 dependencies 的区别?
    • 要点:前者只声明版本不引入,后者实际引入。
  3. mock 与 spy 的区别?
    • 要点:mock 全假,spy 包裹真实对象可部分打桩。
  4. 为什么日志用占位符而不是字符串拼接?
    • 要点:延迟求值、避免无意义拼接、结构化。
  5. 单元测试为什么不要连真实数据库?
    • 要点:慢、不稳、环境依赖;用 mock/Testcontainers 分离关注点。
  6. mvn package 会连带执行哪些阶段?
    • 要点:validate、compile、test、package。