Java Debug如何调试单元测试

Java 单元测试的 Debug 实战指南

一、快速上手步骤

• 在代码中设置断点：在行号左侧单击或右键选择 Toggle Breakpoint。
• 以调试模式运行测试：在 IntelliJ IDEA 中点击测试类或方法旁的绿色箭头选择 Debug ‘测试名’，或使用快捷键 Shift+F9；在 Eclipse 中右键选择 Debug As → JUnit Test。
• 控制执行与观察状态：使用 Step Over(F8)/Step Into(F7)/Step Out(Shift+F8) 逐步执行；在 Variables 窗口查看当前作用域变量；用 Evaluate Expression 实时计算表达式或修改变量值以验证修复思路。
• 常用调试窗口与操作：查看 Call Stack 了解调用路径，使用 Resume Program(F9) 跳到下一个断点，借助 Run to Cursor(Alt+F9) 快速抵达光标处。

二、IDE 中的高效调试技巧

• 条件断点：右键断点设置条件（如 i == 100），仅在满足条件时暂停，适合循环与高频调用场景。
• 日志与断言配合：在关键路径补充日志（如 SLF4J/Log4j），断言失败时结合断点定位根因，减少盲目单步。
• 异常断点：为特定异常（如 NullPointerException）设置异常断点，抛出即停，快速定位问题源头。
• 覆盖率与回归：使用 Run with Coverage 查看行/分支覆盖，优先补充未覆盖分支的用例；失败用例用 Rerun Failed Tests 快速回归。

三、JUnit 场景下的要点

• 运行与调试粒度：可直接对单个测试类、单个方法或批量测试运行/调试；在 IDEA 的 Run/Debug Configurations → Configuration → Method 可指定仅运行的方法。
• 断言与失败分析：利用 assertEquals/assertThrows 等断言快速发现问题；测试失败时查看堆栈与失败消息，必要时在断言前后设置断点核对输入输出。
• 运行器与配置：在 JUnit 4 中可用 @RunWith 指定运行器（如 BlockJUnit4ClassRunner）；大多数 IDE 的调试运行会处理好运行器与类路径，无需额外改动即可断点调试。

四、常见问题与排查清单

• 断点未命中：确认调试的是期望的测试类/方法；检查构建是否最新（必要时 Rebuild）；确认未使用 @Ignore 或条件跳过；在 Spring Boot 等场景，确保测试上下文正确加载（如使用合适的注解与配置）。
• 依赖与资源不一致：在 IDEA 中执行测试时，test 模块的资源与类路径优先于 main 模块，同名资源以 test 为准；排查配置、数据文件是否落在正确目录。
• 断点命中但变量不可见：可能已被编译器优化或超出作用域；尝试在更靠近使用位置设置断点，或使用 Evaluate Expression 查看对象状态。
• 外部服务/数据库依赖导致难复现：优先用 Mockito 等模拟依赖，或将依赖改为可重置的测试替身；对集成测试再考虑 Testcontainers 等可控环境。

五、一分钟示例

• 代码示例：

import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.*;

class Calculator {
    int add(int a, int b) { return a + b; }
}

class CalculatorTest {
    @Test
    void testAdd() {
        Calculator c = new Calculator();
        int r = c.add(2, 3);
        assertEquals(5, r);
    }
}

• 调试步骤：在 add 方法第一行设断点 → 在测试类或方法旁选择 Debug → 使用 F8/F7 逐步执行 → 在 Variables 查看 a、b、r 的值 → 若需要，用 Evaluate Expression 验证其他输入组合。