无法通过TestNG Runner运行Cucumber，直接运行Feature文件正常

错误信息翻译 #

[TestNG] 未找到测试用例，未执行任何测试
使用方式: <主类> [选项] 要运行的XML套件文件
选项:
-alwaysrunlisteners
是否即使在方法被跳过的情况下也运行MethodInvocation监听器
默认值: true
-configfailurepolicy
配置失败策略（跳过或继续）
-d
输出目录
-dataproviderthreadcount
运行数据提供者时使用的线程数
-dependencyinjectorfactory
TestNG应使用的依赖注入工厂实现
-excludegroups
要排除的组名列表，用逗号分隔
-failwheneverythingskipped
如果所有测试都被跳过且未执行任何测试，是否让TestNG标记执行失败
默认值: false
-generateResultsPerSuite
是否将数据提供者中的失败视为测试失败
默认值: false
-groups
要运行的组名列表，用逗号分隔
-ignoreMissedTestNames
如果'-testnames'指定的测试名不存在，是否忽略并继续运行现有测试（如果有）
默认值: false
-includeAllDataDrivenTestsWhenSkipping
如果上游失败，是否将数据驱动测试的所有迭代都报告为单独的跳过
默认值: false
-junit
JUnit模式
默认值: false
-listener
实现ITestListener或ISuiteListener的.class文件列表或类名列表
-methods
测试方法列表，用逗号分隔
默认值: []
-methodselectors
实现IMethodSelector的.class文件列表或类名列表
-mixed
混合模式 - 自动检测当前测试类型并使用相应的运行器运行
默认值: false
-objectfactory
实现ITestRunnerFactory的.class文件列表或类名列表
-overrideincludedmethods
应跳过通过服务加载器连接的监听器的全限定类名列表，用逗号分隔
默认值: false
-parallel
并行模式（方法、测试或类）
可选值: [tests, methods, classes, instances, none]
-port
端口
-propagateDataProviderFailureAsTestFailure
是否将数据提供者中的失败视为测试失败
默认值: false
-reporter
自定义报告监听器的扩展配置
-spilistenerstoskip
应跳过通过服务加载器连接的监听器的全限定类名列表，用逗号分隔
默认值: <空字符串>
-suitename
测试套件的默认名称（如果未在套件定义文件或源代码中指定）
-suitethreadpoolsize
运行套件时使用的线程池大小
默认值: 1
-testclass
测试类列表
-testjar
包含测试的jar文件
-testname
测试的默认名称（如果未在套件定义文件或源代码中指定）
-testnames
要运行的测试名列表
-testrunfactory, -testRunFactory
用于创建测试的工厂
-threadcount
并行运行测试时使用的线程数
-threadpoolfactoryclass
TestNG应使用的线程池执行器工厂实现
-usedefaultlisteners
是否使用默认监听器
默认值: true
-log, -verbose
详细程度级别
-xmlpathinjar
jar文件中xml文件的完整路径（仅在指定-testjar时有效）
默认值: testng.xml

解决步骤 #

1. 检查TestNG Runner类的注解配置 #

确保Cucumber+TestNG Runner类注解配置正确，示例如下：

import io.cucumber.testng.AbstractTestNGCucumberTests;
import io.cucumber.testng.CucumberOptions;

@CucumberOptions(
    features = "src/test/resources/features", // 指向你的Feature文件路径
    glue = "com.yourpackage.stepdefinitions", // 步骤定义类所在包
    plugin = {"pretty", "html:target/cucumber-reports"}
)
public class TestNGRunner extends AbstractTestNGCucumberTests {
}

• 确认features路径准确，能定位到目标Feature文件
• glue指定的包必须包含对应的步骤定义类

2. 验证TestNG XML配置文件 #

如果用TestNG XML运行，确保文件正确引用Runner类：

<!DOCTYPE suite SYSTEM "https://testng.org/testng-1.0.dtd">
<suite name="Cucumber Test Suite">
    <test name="Cucumber Tests">
        <classes>
            <class name="com.yourpackage.TestNGRunner"/> <!-- 替换为你的Runner类全限定名 -->
        </classes>
    </test>
</suite>

• 检查XML中的类名拼写、包路径是否无误

3. 确保依赖版本兼容 #

检查Cucumber和TestNG的依赖版本是否匹配，以Maven为例：

<dependencies>
    <!-- Cucumber TestNG依赖 -->
    <dependency>
        <groupId>io.cucumber</groupId>
        <artifactId>cucumber-testng</artifactId>
        <version>7.14.0</version>
        <scope>test</scope>
    </dependency>
    <!-- TestNG依赖 -->
    <dependency>
        <groupId>org.testng</groupId>
        <artifactId>testng</artifactId>
        <version>7.8.0</version>
        <scope>test</scope>
    </dependency>
</dependencies>

• 避免版本冲突，建议使用官方推荐的兼容版本组合

4. 清理并重新编译项目 #

编译缓存可能导致TestNG无法识别测试类，执行以下操作：

• 清理项目：Maven执行mvn clean，Gradle执行gradle clean
• 重新编译：Maven执行mvn compile test-compile，Gradle执行gradle compileTestJava
• 再次尝试通过TestNG Runner运行

5. 检查IDE运行配置 #

如果在IDE（如IntelliJ IDEA/Eclipse）中运行：

• 确认运行配置选择的是正确的TestNG XML文件或Runner类
• 检查配置中是否存在错误的过滤条件（如错误的组名、测试名）

6. 确认Feature与步骤定义匹配 #

虽然直接运行Feature文件正常，但仍需确认：

• Feature文件中的场景、步骤与步骤定义类的方法完全匹配
• 步骤定义类未被错误标记@Ignore或其他跳过注解

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