覆盖率与质量门禁

这一课你将能做到

1. 给 backend 配置 JaCoCo，本地生成并读懂 HTML 覆盖率报告（行覆盖 vs 分支覆盖）
2. 指出「高覆盖仍漏 bug」的典型成因，识别三种虚高覆盖
3. 起草一条团队可落地的门禁规约：阈值、排除名单、禁止假绿条款

为什么要学

覆盖率统计「测试执行时碰到了哪些行 / 分支」。Java 侧工具是 JaCoCo，前端是 V8 coverage / Istanbul。人话：覆盖率是地图，标出没人走过的黑区；它不是目的地——assertTrue(true) 也能刷出行覆盖，绿灯数字从来不证明行为正确。

它真正的用法是导航：改完 SubmissionService，打开报告看这次改动的分支有没有被测到；看 AuthService 哪些校验分支从没红过。而**质量门禁（quality gate）**把报告变成「能不能合并」：关键包分支覆盖低于阈值就让 mvn verify 失败。门禁要温和且可执行——一上来全仓 95% 只会逼人写空测、乱加排除。

面试高频：「覆盖率多少合适？」——本课给你一个能背、能自圆其说的答案。

先建立图像

代码行 ────────────────► 被测试跑到了吗？ → line %
   └─ if / switch 分支 ─► 真假两边都跑过吗？ → branch %

高 line + 弱断言 = 假安全感
有意义断言 + 关键模块下限 = 可用门禁

指标	含义	局限
Line	行是否执行到	不保证断言正确
Branch	分支两边是否都走到	仍可能漏状态组合
变更覆盖	PR 改动行是否被测	对遗留债最务实

金字塔提醒：提覆盖的主战场在单元与薄 MockMvc 层；逼 E2E 刷覆盖又慢又脆。

跟着做

步骤 1：给 backend 挂上 JaCoCo

backend/pom.xml 的 <build><plugins> 里加：

<plugin>
    <groupId>org.jacoco</groupId>
    <artifactId>jacoco-maven-plugin</artifactId>
    <executions>
        <execution>
            <goals><goal>prepare-agent</goal></goals>
        </execution>
        <execution>
            <id>report</id>
            <phase>verify</phase>
            <goals><goal>report</goal></goals>
        </execution>
    </executions>
</plugin>

人话：prepare-agent 在测试运行时插桩统计；report 在 verify 阶段生成 HTML。注意它挂在 verify——这就是为什么 CI 用 mvn -B verify 而不是只 test。

步骤 2：生成并打开报告

cd backend
mvn verify
# 报告位置：
# target/site/jacoco/index.html

浏览器打开 index.html，固定浏览顺序：先看你刚改的包 → 再看 branch 最低的类 → 最后才看全仓均值。均值会安慰人，局部黑洞才害人。点进 SubmissionService：submit 的语言白名单、代码长度、课时校验应该都是绿的菱形（分支两边都走到）或至少有一条已测——红的分支就是盲区。