在Eclipse中调试Cucumber Feature文件时无法步入Java代码的问题

问题背景 #

操作步骤 #

• 在Eclipse 2022-09中使用io.cucumber的cucumber-archetype创建全新的Cucumber Maven项目
• 在StepDefinition Java源码中设置断点
• 对编辑器中打开的Feature文件执行「Debug as Cucumber Feature」
• 禁用步骤过滤器，确保未过滤任何内容

实际现象 #

执行「Step into」时虽能正常推进，但无法进入Java源码逐行查看执行过程

已尝试方法 #

• 转换为Cucumber项目特性
• 执行Maven更新项目

项目依赖 #

测试项目除导入cucumber-bom和junit-bom外，还包含以下测试范围依赖：

• cucumber-java 7
• cucumber-junit-platform-engine 7
• junit-platform-suite 1.9.1
• junit-jupiter 5.9.1

问题解答 #

1. 你的预期是否不合理？ #

完全合理。Cucumber在Eclipse中支持步进调试进入StepDefinition源码，和调试JUnit5测试的体验一致是正常的功能预期，不存在不合理性。

2. 是否遗漏关键配置步骤？ #

是的，你可能遗漏了编译调试信息生成、Eclipse调试器规则或Cucumber插件的关键配置，这些都会导致无法步进进入源码。

3. 如何配置实现代码步进？ #

按以下步骤逐一排查配置：

（1）确保Maven编译保留调试信息

在项目pom.xml的build节点中添加maven-compiler-plugin配置，确保编译时生成完整的调试信息：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.11.0</version>
            <configuration>
                <debug>true</debug>
                <debugLevel>lines,vars,source</debugLevel>
            </configuration>
        </plugin>
    </plugins>
</build>

（2）检查Eclipse调试器过滤规则

• 打开Window > Preferences > Java > Debug > Step Filtering，确认未勾选过滤你的StepDefinition所在的包/类，同时取消所有不必要的系统类过滤（若之前勾选）
• 打开Window > Preferences > Java > Debug > Debugger，确保勾选「Allow stepping into methods without source」（避免因依赖类无源码影响步进逻辑）

（3）验证Cucumber插件配置

• 确认安装的Cucumber Eclipse插件版本与Cucumber 7.x兼容（建议使用1.0.0+版本，可通过Eclipse Marketplace查看插件版本）
• 右键项目 → Properties > Cucumber，确认「Step Definition Search Path」已包含你的StepDefinition所在的源码目录（例如src/test/java/com/your/stepdefs）

（4）重新构建项目

• 执行Maven命令：mvn clean install
• 在Eclipse中执行Project > Clean，选择当前项目清理后重新构建

（5）更换调试启动方式

若「Debug as Cucumber Feature」仍有问题，尝试使用JUnit Platform调试配置：

1. 打开Run > Debug Configurations > JUnit，新建一个配置
2. 选择你的项目，在「Test class」中选择带有@Suite注解的测试启动类（若使用套件模式），或直接指定Cucumber的运行类
3. 启动调试，此时执行「Step into」应能正常进入StepDefinition源码

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