运行测试套件是否需引入junit-jupiter-engine依赖？

核心结论：运行JUnit Jupiter测试必须依赖junit-jupiter-engine，仅引入junit-jupiter-api只能保证测试代码编译通过，无法实际启动执行测试。

你遇到的「未显式引入engine也能跑通测试」的情况，本质是项目里的其他依赖或构建插件已经把junit-jupiter-engine作为传递依赖拉进来了：比如Maven的surefire/failsafe插件、Gradle官方JUnit插件、Spring Boot Test Starter这类常用组件，都会默认传递引入对应版本的junit-jupiter-engine，你没有在构建配置里手动声明，不代表依赖树里不存在这个包，执行mvn dependency:tree或gradle dependencies就能在输出里看到它的路径。

两个依赖的核心差异 #

两者定位完全不同，可以用餐厅运作的逻辑做类比：

• junit-jupiter-api 是面向测试代码编写者的公开契约：我们写测试时用到的@Test注解、各类断言方法、测试扩展接口定义都在这个包里。它相当于餐厅对外公示的菜单、服务规范，写代码时只需要对照这些规则编写，编译阶段只要引入这个包，代码就不会报语法错误，就像顾客照着菜单点菜不需要知道后厨的炒菜流程。
• junit-jupiter-engine 是面向JUnit运行时的执行核心：它负责扫描项目里的测试类、解析@Test等各类测试注解、实际执行测试逻辑、捕获断言异常和业务异常、统计测试成功/失败数量、对接构建工具生成测试报告。它相当于餐厅的后厨、传菜、结算全链路执行团队，没有这个角色，就算测试代码写得完全符合api规范，也没有程序会实际运行这些测试逻辑，就像你拿着菜单点完菜，没有后厨根本做不出餐。

你可以自己做个最小实验验证：新建一个空项目，只引入junit-jupiter-api依赖，写一个最简单的测试方法执行，会直接收到「找不到JUnit Platform测试引擎」的报错，所有测试类都不会被识别。此时只需要补上junit-jupiter-engine依赖，不需要改任何测试代码，测试就能正常运行。

日常开发不需要手动分别引入api和engine，直接依赖junit-jupiter聚合依赖即可，它会自动引入版本完全匹配的api、engine、参数化测试等常用模块，避免出现版本不兼容的问题。

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