添加cucumber-junit-platform-engine后mvn install testCompile报错无法访问包

核心问题拆解 #

1. 无法访问pirate包：Cucumber的JUnit Platform引擎会关联resources下.feature文件与对应包的步骤定义类，当包结构不匹配、Maven资源映射配置缺失时，会触发该错误。
2. junit-platform-engine-1.9.1.jar为空：基本是Maven依赖缓存损坏，或版本冲突导致依赖下载不完整。

分步解决方案 #

1. 对齐依赖版本，修复配置 #

Cucumber与JUnit Platform版本必须兼容，建议用统一版本管理避免冲突：

<properties>
    <cucumber.version>7.14.0</cucumber.version>
    <junit-platform.version>1.9.3</junit-platform.version>
</properties>

<dependencies>
    <!-- Cucumber核心依赖 -->
    <dependency>
        <groupId>io.cucumber</groupId>
        <artifactId>cucumber-java</artifactId>
        <version>${cucumber.version}</version>
        <scope>test</scope>
    </dependency>
    <!-- 必须保留的Cucumber JUnit Platform引擎，否则无法运行测试 -->
    <dependency>
        <groupId>io.cucumber</groupId>
        <artifactId>cucumber-junit-platform-engine</artifactId>
        <version>${cucumber.version}</version>
        <scope>test</scope>
    </dependency>
    <!-- JUnit Platform测试启动器 -->
    <dependency>
        <groupId>org.junit.platform</groupId>
        <artifactId>junit-platform-launcher</artifactId>
        <version>${junit-platform.version}</version>
        <scope>test</scope>
    </dependency>
</dependencies>

2. 匹配包结构 #

• 步骤定义类（如PirateSteps.java）必须放在src/test/java/pirate目录，与src/test/resources/pirate的.feature文件目录结构完全对应。
• 在.feature文件顶部明确指定包：

Feature: 海盗相关测试
Package: pirate

3. 修复损坏的依赖缓存 #

删除本地Maven仓库中损坏的jar包（路径一般为~/.m2/repository/org/junit/platform/junit-platform-engine/1.9.1），然后执行强制更新命令：

mvn clean install -U

4. 调整Runner类配置 #

无需继承JUnit 4类，仅用@Cucumber注解即可：

package pirate;

import io.cucumber.junit.platform.engine.Cucumber;

@Cucumber
public class PirateTestRunner {
}

验证流程 #

1. 执行mvn clean test-compile，确认包访问错误消失。
2. 执行mvn clean test，查看控制台输出，确认Cucumber测试正常执行。

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