在IntelliJ IDEA中运行JUnit测试时如何精简堆栈跟踪？

问题背景 #

在IntelliJ IDEA中运行Gradle项目的JUnit 5单元测试时，会生成包含大量JUnit、Gradle及JDK内部类的超长堆栈跟踪信息，难以快速定位到自己代码中的问题点。使用版本：IntelliJ IDEA 2022.1.2（旗舰版）、Gradle 7.3.3、JUnit 5.8.2。

解决方案 #

一、通过Gradle配置实现堆栈过滤 #

修改项目根目录下的build.gradle（Groovy）或build.gradle.kts（Kotlin）文件，配置测试任务的日志输出规则：

1. 使用Gradle内置短格式堆栈输出

该配置会自动过滤框架内部的无关堆栈信息：

Groovy 语法（build.gradle）

test {
    useJUnitPlatform()
    testLogging {
        // 只显示关键堆栈信息，隐藏框架内部调用
        exceptionFormat = 'short'
        // 仅输出失败测试的日志，减少冗余
        events 'failed'
    }
}

Kotlin 语法（build.gradle.kts）

tasks.test {
    useJUnitPlatform()
    testLogging {
        exceptionFormat = org.gradle.api.tasks.testing.logging.TestExceptionFormat.SHORT
        events(org.gradle.api.tasks.testing.logging.TestLogEvent.FAILED)
    }
}

2. 自定义排除特定包的堆栈

如果需要更精准控制，可指定排除JUnit、Gradle或JDK相关包：

Groovy 语法

test {
    useJUnitPlatform()
    testLogging {
        stackTraceFilters {
            // 排除指定前缀的包路径
            exclude 'org.junit.**', 'org.gradle.**', 'java.base.**'
        }
    }
}

Kotlin 语法

tasks.test {
    useJUnitPlatform()
    testLogging {
        stackTraceFilters {
            exclude("org.junit.**", "org.gradle.**", "java.base.**")
        }
    }
}

3. 启用JUnit 5原生堆栈过滤

JUnit 5提供系统属性控制堆栈过滤模式，添加到Gradle测试任务的JVM参数中：

Groovy 语法

test {
    useJUnitPlatform()
    jvmArgs '-Djunit.jupiter.execution.stacktrace.filter.mode=essential'
}

Kotlin 语法

tasks.test {
    useJUnitPlatform()
    jvmArgs("-Djunit.jupiter.execution.stacktrace.filter.mode=essential")
}

mode参数可选值：

• essential：仅保留用户代码和关键框架信息
• default：默认模式，保留部分框架信息
• all：显示完整堆栈
• none：完全不过滤

二、通过IntelliJ IDEA配置实现堆栈过滤 #

1. 针对单个测试配置设置

1. 点击右上角运行按钮旁的下拉菜单，选择Edit Configurations
2. 在左侧列表中找到对应的JUnit或Gradle Test配置
3. 在Configuration标签页的Log区域：
   • 选择Stack trace为Short，快速精简堆栈
   • 或点击Configure按钮，自定义添加要排除的包（如org.junit.*、org.gradle.*）
4. 也可在VM options中添加-Djunit.jupiter.execution.stacktrace.filter.mode=essential，复用JUnit 5的过滤规则

2. 全局配置（统一应用到所有测试）

1. 打开File > Settings（Windows/Linux）或IntelliJ IDEA > Preferences（Mac）
2. 导航到Build, Execution, Deployment > Build Tools > Gradle > Runner
3. 勾选Delegate IDE build/run actions to Gradle，让IDEA直接使用Gradle中配置的测试日志规则
4. （可选）导航到Build, Execution, Deployment > Debugger > Data Views > Java Stack Traces，在Exclude classes列表中添加需要隐藏的包前缀，实现调试时的堆栈过滤

内容的提问来源于stack exchange，提问作者Slava Semushin