Cucumber报GherkinDocumentBuilder构造方法不存在错误解决方案

抛出java.lang.NoSuchMethodError: 'void io.cucumber.gherkin.GherkinDocumentBuilder.<init>(io.cucumber.messages.IdGenerator, java.lang.String)'的核心原因是Cucumber生态组件版本不兼容：你项目中实际加载的cucumber-gherkin包版本过低，该版本的GherkinDocumentBuilder类没有带(IdGenerator, String)参数的构造方法，但你引入的高版本Cucumber核心组件（cucumber-core、cucumber-java等）调用时需要匹配这个构造方法签名，最终触发方法找不到的错误。

这类问题绝大多数是依赖版本不一致、存在传递依赖冲突导致的，按以下步骤操作即可解决：

• 统一所有Cucumber组件的版本，不要单独为单个cucumber-*依赖指定版本。优先通过Cucumber官方BOM（物料清单）管控版本，从根源避免版本错位：
  • Maven用户在pom.xml中添加如下配置：

  <dependencyManagement>
      <dependencies>
          <dependency>
              <groupId>io.cucumber</groupId>
              <artifactId>cucumber-bom</artifactId>
              <version>7.14.0</version> <!-- 可替换为你需要的最新稳定版，所有Cucumber组件会统一使用该版本 -->
              <type>pom</type>
              <scope>import</scope>
          </dependency>
      </dependencies>
  </dependencyManagement>
  
  <dependencies>
      <!-- 引入Cucumber相关依赖时无需单独指定version，版本自动由BOM对齐 -->
      <dependency>
          <groupId>io.cucumber</groupId>
          <artifactId>cucumber-java</artifactId>
          <scope>test</scope>
      </dependency>
      <dependency>
          <groupId>io.cucumber</groupId>
          <artifactId>cucumber-junit</artifactId>
          <scope>test</scope>
      </dependency>
  </dependencies>
  

  • Gradle用户在build.gradle中添加如下配置：

  dependencies {
      // 导入Cucumber BOM统一管控版本
      testImplementation platform('io.cucumber:cucumber-bom:7.14.0')
      testImplementation 'io.cucumber:cucumber-java'
      testImplementation 'io.cucumber:cucumber-junit'
  }
  

• 排查并清理冲突的传递依赖：执行依赖分析命令查看所有Cucumber相关依赖的实际引入版本：
  • Maven用户执行：mvn dependency:tree | findstr cucumber（Windows系统）/ mvn dependency:tree | grep cucumber（Mac/Linux系统）
  • Gradle用户执行：./gradlew dependencies | grep cucumber
    找到输出结果中版本号和你指定的BOM版本不一致的io.cucumber:cucumber-gherkin依赖，定位到是哪个第三方组件传递引入了该低版本包，在对应依赖的配置中添加exclude规则排除掉低版本的cucumber-gherkin即可。
• 清理构建缓存后重新运行：执行构建命令前先清理旧的编译缓存，避免旧版本类被错误加载：
  • Maven执行：mvn clean test
  • Gradle执行：./gradlew clean test

常见踩坑提示：如果项目中引入了第三方Cucumber报表插件、旧版BDD测试工具，这类组件大概率会传递引入低版本的cucumber-gherkin，是版本冲突的高发来源，排查时优先检查这类依赖。

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