Cucumber4测试运行器指定自定义plugin及UD.Plugin类加载报错咨询

报错核心原因 #

你遇到的Could not load plugin class 'UD.Plugin'报错并非插件指定格式错误，核心是Cucumber测试运行时无法找到你开发的插件类。Java运行时识别的是编译后class文件的全限定类名，而非源文件的存放目录，首先需要确认类路径和类名配置正确。

正确配置方法 #

1. 前置校验 #

• 确认你的Plugin类位于UD包下，类顶部有package UD;声明，类名、包名大小写和你写的UD.Plugin完全一致
• 确认Plugin类是public修饰，且提供public无参构造方法
• 确认Plugin类实现了Cucumber 4的cucumber.api.Plugin接口，依赖版本匹配
• 确认构建工具（Maven/Gradle）默认将src/main下的类编译后加入测试运行类路径，无自定义构建配置屏蔽该逻辑

2. TestRunner 注解配置 #

在测试运行器的@CucumberOptions的plugin属性中直接填写插件的全限定类名即可，示例如下：

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

@RunWith(Cucumber.class)
@CucumberOptions(
    // 直接指定全限定类名即可
    plugin = {"UD.Plugin"},
    // 其他配置项按需补充，例如features、glue、tags等
    features = "src/test/resources/features",
    glue = "com.example.stepdefs"
)
public class TestRunner {
}

如果需要将插件的输出内容写入指定路径，可以采用插件全限定名:输出路径的格式，示例：

plugin = {"UD.Plugin:target/custom-plugin-output.log"}

特殊场景处理 #

如果调整后还是报类找不到的错误，可以尝试将插件类从src/main/UD移动到src/test/UD测试源码目录，确保测试运行时一定能加载到类。

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