Android Studio中Cucumber无法找到步骤定义问题求助

我之前也踩过类似的坑，结合你的配置和描述，问题主要集中在依赖版本冲突、旧版Cucumber兼容性，以及路径配置这几个方面，下面一步步帮你解决：

一、核心问题分析 #

1. 过时库与依赖冲突：你用的info.cukes开头的Cucumber是1.x旧版本，这个分支已经停止维护，和你项目里的AndroidX依赖存在兼容性问题；同时你同时引入了androidx.test:runner和com.android.support.test:runner，两个测试Runner会互相干扰。
2. Features路径错误：你的@CucumberOptions里写的features = "resources/features"，但Android Instrumented测试的默认资源目录是src/androidTest/resources/，这个路径会导致Cucumber找不到你的.feature文件。
3. 跨体系依赖冲突：你同时引入了androidx.appcompat和com.android.support:appcompat-v7，这两个库分属不同依赖体系，必然会引发冲突。

二、具体修复步骤 #

1. 替换新版Cucumber并清理冲突依赖 #

把Gradle里的Cucumber依赖换成官方维护的io.cucumber系列，同时移除冲突的测试Runner和Support库：

dependencies {
    // 保留业务依赖，移除冲突的support库
    implementation fileTree(include: ['*.jar'], dir: 'libs')
    implementation 'androidx.appcompat:appcompat:1.2.0-alpha01'
    implementation 'androidx.constraintlayout:constraintlayout:2.0.0-beta4'
    implementation 'androidx.legacy:legacy-support-v4:1.0.0'
    implementation 'com.jakewharton:butterknife:10.2.1'
    implementation 'com.google.android.material:material:1.2.0-alpha03'
    implementation 'com.google.android.libraries.places:places:2.2.0'
    implementation 'androidx.cardview:cardview:1.0.0'
    implementation 'com.google.android.gms:play-services-places:17.0.0'
    implementation 'com.google.android.gms:play-services-wallet:18.0.0'
    // 移除这个冲突的support库
    // implementation 'com.android.support:appcompat-v7:28.0.0'
    annotationProcessor 'com.jakewharton:butterknife-compiler:10.2.1'

    // 单元测试依赖
    testImplementation 'junit:junit:4.12'

    // 统一用AndroidX的Instrumented测试依赖
    androidTestImplementation 'androidx.test:runner:1.4.0'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.4.0'
    // 替换为兼容AndroidX的新版Cucumber
    androidTestImplementation 'io.cucumber:cucumber-android:4.8.1'
    androidTestImplementation 'io.cucumber:cucumber-junit:4.8.1'
    androidTestImplementation 'io.cucumber:cucumber-picocontainer:4.8.1'
}

2. 修正Cucumber配置类 #

更新配置类的导入包（换成io.cucumber），并修正features路径：

package app.waxbee.stepdefinitions;

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

@RunWith(Cucumber.class)
@CucumberOptions(
    features = "features", // 对应src/androidTest/resources/features目录
    glue = "app.waxbee.stepdefinitions",
    // 可选：开启dryRun可快速检查所有步骤是否已定义，调试完再改成false
    dryRun = false,
    monochrome = true // 让控制台输出更整洁
)
public class CucumberTestCase { }

3. 确认项目结构与步骤定义 #

• 确保.feature文件放在src/androidTest/resources/features目录下；
• 检查步骤定义的Java文件确实在app.waxbee.stepdefinitions包下，并且每个步骤的注解（@Given/@When/@Then）和feature文件里的文本完全匹配（包括空格、大小写、参数占位符）。

4. 清理缓存并重建项目 #

执行Android Studio的File -> Invalidate Caches / Restart，然后重新构建项目，避免缓存导致的异常。

三、优化建议 #

• 彻底切换AndroidX：移除所有com.android.support开头的依赖，统一用AndroidX系列，从根源避免依赖冲突；
• 保持Cucumber版本更新：io.cucumber会持续维护，后续可以关注官方版本更新，获得更好的兼容性；
• 添加测试报告：可以在@CucumberOptions里加上plugin = {"pretty", "html:reports/cucumber-report.html"}，生成可视化的测试报告；
• 调试小技巧：开启dryRun = true时，Cucumber会检查所有步骤是否都有定义，不会执行实际测试，适合快速排查未定义的步骤。

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