使用JUnit Cucumber生成Extent报告时遇插件类加载异常求助

你遇到的cucumber.runtime.CucumberException: Couldn't load plugin class: com.cucumber.listener.ExtentCucumberFormatter错误，通常是依赖缺失、版本不兼容或者配置错误导致的，下面是具体的排查和修复步骤：

1. 确认依赖是否正确引入 #

com.cucumber.listener.ExtentCucumberFormatter属于旧版的Cucumber-ExtentReport适配器，需要在pom.xml中添加以下两个依赖（注意版本要和你的Cucumber版本匹配）：

<!-- ExtentReports核心依赖 -->
<dependency>
    <groupId>com.relevantcodes</groupId>
    <artifactId>extentreports</artifactId>
    <version>2.41.2</version>
    <scope>test</scope>
</dependency>
<!-- Cucumber与ExtentReports的适配器 -->
<dependency>
    <groupId>com.vimalselvam</groupId>
    <artifactId>cucumber-extentsreport</artifactId>
    <version>3.1.1</version>
    <scope>test</scope>
</dependency>

注意：如果你的Cucumber版本是5.x及以上，旧版的适配器已经不再兼容，需要使用新版的ExtentReports适配器，依赖和类名都会变化：

<dependency>
    <groupId>com.aventstack</groupId>
    <artifactId>extentreports</artifactId>
    <version>5.0.9</version>
</dependency>
<dependency>
    <groupId>com.aventstack</groupId>
    <artifactId>extentreports-cucumber7-adapter</artifactId>
    <version>1.9.0</version>
    <scope>test</scope>
</dependency>

对应的插件类名要改为com.aventstack.extentreports.cucumber.adapter.ExtentCucumberAdapter

2. 检查Runner类的插件配置 #

确保你的Cucumber Runner类中，@CucumberOptions的plugin属性配置正确：

旧版适配器配置： #

import org.junit.runner.RunWith;
import cucumber.api.CucumberOptions;
import cucumber.api.junit.Cucumber;
import com.cucumber.listener.ExtentProperties;
import org.junit.BeforeClass;

@RunWith(Cucumber.class)
@CucumberOptions(
    features = "src/test/resources/features", // 你的features文件路径
    glue = {"stepDefinitions"}, // 你的步骤定义包路径
    plugin = {
        "com.cucumber.listener.ExtentCucumberFormatter:target/cucumber-reports/extent-report.html"
    },
    monochrome = true
)
public class TestRunner {
    @BeforeClass
    public static void setupExtentReport() {
        // 配置报告路径（可选，也可以通过plugin参数指定）
        ExtentProperties extentProperties = ExtentProperties.INSTANCE;
        extentProperties.setReportPath("target/cucumber-reports/extent-report.html");
    }
}

新版适配器配置（Cucumber 5+）： #

import org.junit.runner.RunWith;
import io.cucumber.junit.Cucumber;
import io.cucumber.junit.CucumberOptions;

@RunWith(Cucumber.class)
@CucumberOptions(
    features = "src/test/resources/features",
    glue = {"stepDefinitions"},
    plugin = {
        "com.aventstack.extentreports.cucumber.adapter.ExtentCucumberAdapter:"
    },
    monochrome = true
)
public class TestRunner {
    // 新版适配器不需要额外初始化，报告默认生成在target/extent-report.html
}

3. 排查其他可能问题 #

• 依赖未下载：执行mvn clean install -U强制更新依赖，确保所有依赖都正确下载到本地仓库
• 类名拼写错误：检查插件类名是否完全正确，比如大小写、包名是否写错（旧版是com.cucumber.listener.ExtentCucumberFormatter，不要少写或者多写字符）
• 报告目录权限：确保target/cucumber-reports目录存在，且当前用户有读写权限，避免因为无法写入报告文件导致的加载失败

按照以上步骤逐一排查，应该能解决插件加载失败的问题。

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