Gradle自定义Cucumber任务无法识别步骤，执行时提示步骤未定义需重新实现

问题场景 #

我在Gradle里写了个自定义的Cucumber测试任务来跑Selenium BDD测试，但一执行任务就弹出步骤未定义的错误，要求重新实现步骤。我的任务代码如下：

task seleniumbddTest() {
    dependsOn assemble, testClasses
    doLast {
        javaexec {
            main = "io.cucumber.core.cli.Main"
            classpath = configurations.cucumberRuntime + sourceSets.main.output + sourceSets.test.output
            args = ['--plugin', 'html:target/seleniumreport' + getTime() + '.html', '--plugin', 'pretty', '--glue', 'Capsone.steps', 'src/seleniumbdd/resources', '--tags', '@Test']
        }
    }
}

我的项目文件夹结构大概是这样：

├── src
│   ├── main
│   │   └── java
│   ├── test
│   │   └── java
│   │       └── Capsone
│   │           └── steps
│   │               └── [步骤定义类文件]
│   └── seleniumbdd
│       └── resources
│           └── [Feature用例文件]
├── build.gradle

可能的原因分析 #

遇到“步骤未定义”，大概率是Cucumber找不到你的步骤定义类或者Feature文件，常见坑点有这几个：

1. Glue路径大小写不匹配：Java包名一般是小写规范，你写的Capsone.steps首字母大写，可能和实际包名capsone.steps不对应
2. Classpath配置不全：自定义任务的classpath可能没正确包含测试类的输出目录，导致Cucumber扫不到步骤定义
3. 自定义资源目录未注册：你把Feature文件放在src/seleniumbdd/resources，Gradle默认不会识别这个目录为资源目录，文件可能没被加载到classpath
4. getTime()方法未定义：任务里用了这个方法但没实现，可能导致报告路径生成失败，间接影响任务执行逻辑

针对性解决方案 #

方案1：修正任务配置，改用Test类型任务（更规范） #

推荐直接用Gradle的Test类型任务来封装Cucumber执行，比在doLast里调用javaexec更稳定：

task seleniumbddTest(type: Test) {
    dependsOn assemble, testClasses
    useJUnitPlatform() // Cucumber 7+需要依赖JUnit平台
    classpath = configurations.cucumberRuntime + sourceSets.main.output + sourceSets.test.output
    testClassesDirs = sourceSets.test.output.classesDirs // 明确指定测试类目录

    mainClass = "io.cucumber.core.cli.Main"
    args = [
        '--plugin', "html:target/seleniumreport-${new Date().format('yyyyMMddHHmmss')}.html", // 用标准日期格式化替换getTime()
        '--plugin', 'pretty',
        '--glue', 'capsone.steps', // 修正包名大小写，和实际步骤类包一致
        'src/seleniumbdd/resources',
        '--tags', '@Test'
    ]
}

方案2：注册自定义Feature文件目录 #

把你的src/seleniumbdd/resources添加为测试资源目录，让Gradle正确处理这些文件：

sourceSets {
    test {
        resources {
            srcDirs += 'src/seleniumbdd/resources'
        }
    }
}

配置完后，你还可以把Feature路径改成classpath:，让Cucumber直接从classpath里找文件，更灵活：

args = [
    // ...其他参数
    '--glue', 'capsone.steps',
    'classpath:', // 从classpath根目录扫描Feature文件
    '--tags', '@Test'
]

方案3：确保Cucumber依赖配置正确 #

检查你的build.gradle里有没有配齐必要的Cucumber依赖，比如：

dependencies {
    testImplementation 'io.cucumber:cucumber-java:7.14.0'
    testImplementation 'io.cucumber:cucumber-junit-platform-engine:7.14.0'
    testImplementation 'org.junit.platform:junit-platform-suite-api:1.10.0'
    testRuntimeOnly 'org.junit.platform:junit-platform-launcher:1.10.0'
    // 加上你的Selenium等其他依赖
}

configurations {
    cucumberRuntime {
        extendsFrom testImplementation
    }
}

最后再做2个检查 #

• 确认步骤定义类里的@Given/@When/@Then注解的文本，和Feature文件里的步骤完全匹配（包括空格、大小写）
• 确认你的Feature文件里确实有标记@Test的场景，不然Cucumber找不到可执行的用例，也可能误报步骤未定义

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