Cucumber4集成qaf-cucumber报错QAFCucumberPlugin未实现Plugin接口

• 版本适配错误：引入的qaf-cucumber 2.1.15-beta-1是适配Cucumber 3.x版本的构建包，该版本下QAFCucumberPlugin实现的是Cucumber 3的cucumber.api.Plugin接口；但项目使用的是Cucumber 4.5.1，从Cucumber 4开始Plugin接口的包路径已迁移为io.cucumber.plugin.Plugin，类加载时判定插件未实现对应接口，直接抛出异常。
• 依赖冲突：项目单独引入了5.1.3版本的cucumber-plugin依赖，和4.5.1版本的cucumber-core、cucumber-java跨大版本不兼容，会打乱正常的类加载逻辑，放大接口不匹配问题。
• 冗余依赖：pom中重复声明了2次junit 4.13.1、2次cucumber-junit 4.5.1，冗余依赖容易触发maven版本仲裁异常，导致实际加载的依赖版本和预期不符。

1. 修正pom.xml依赖配置 #

• 将qaf-cucumber版本替换为适配Cucumber 4的2.1.15-beta-2（对应cucumber-4分支的正式构建包，已适配Cucumber 4的Plugin接口路径）
• 删除单独引入的5.1.3版本cucumber-plugin依赖，所有Cucumber生态组件统一使用4.5.1版本，禁止跨大版本混用
• 清理重复声明的junit、cucumber-junit依赖，仅保留一份声明
  修正后的核心依赖代码如下：

<dependencies>
    <dependency>
        <groupId>com.qmetry</groupId>
        <artifactId>qaf</artifactId>
        <version>2.1.15</version>
    </dependency>
    <dependency>
        <groupId>com.qmetry</groupId>
        <artifactId>qaf-cucumber</artifactId>
        <version>2.1.15-beta-2</version>
    </dependency>
    <dependency>
        <groupId>io.cucumber</groupId>
        <artifactId>cucumber-java</artifactId>
        <version>4.5.1</version>
    </dependency>
    <dependency>
        <groupId>io.cucumber</groupId>
        <artifactId>cucumber-junit</artifactId>
        <version>4.5.1</version>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>io.cucumber</groupId>
        <artifactId>cucumber-core</artifactId>
        <version>4.5.1</version>
    </dependency>
    <dependency>
        <groupId>com.aventstack</groupId>
        <artifactId>extentreports-cucumber4-adapter</artifactId>
        <version>1.0.8</version>
        <scope>compile</scope>
    </dependency>
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.13.1</version>
        <scope>compile</scope>
    </dependency>
    <dependency>
        <groupId>net.masterthought</groupId>
        <artifactId>cucumber-reporting</artifactId>
        <version>4.10.0</version>
    </dependency>
</dependencies>

2. 调整测试运行类配置 #

QAF会通过SPI机制自动注册QAFCucumberPlugin，不需要手动在@CucumberOptions的plugin项中重复声明，移除该配置即可，修正后的Runner代码：

import io.cucumber.junit.CucumberOptions;
import io.cucumber.junit.Cucumber;
import org.junit.runner.RunWith;
@RunWith(Cucumber.class)
@CucumberOptions(
    features="src/main/java/Features",
    glue={"StepDefs"},
    monochrome=true,
    plugin = { "pretty" }
)
public class JunitRunner {
}

3. 补充QAF基础配置 #

在项目resources目录下新建application.properties文件，添加配置开启外部测试数据加载能力：

# 开启Scenario Outline外部数据文件加载支持
cucumber.examples.datafile.enable=true
# 指定全局文件编码
qaf.encoding=UTF-8

4. 校验测试数据文件 #

当前feature中Examples:{'datafile':'resources/testdata.json'}的语法符合QAF要求，需要确保testdata.json为标准JSON数组格式，数组中每个对象的key和feature中的占位符（如<searchKey>）完全一致即可。

调整完配置后先执行mvn clean命令清空本地编译缓存，再重新拉取依赖编译运行，避免旧版本残留类文件触发异常。

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