Appium+Cucumber+TestNG运行报IncompatibleClassChangeError求解决方案

你遇到的java.lang.IncompatibleClassChangeError报错本质是Cucumber生态相关依赖的版本不兼容，具体问题如下：

• 第三方报告依赖冲突：你引入的cucumber-extentsreport:3.1.0、cucumber-reports:1.0.7仅适配Cucumber 2.x/3.x版本，内置了旧版本Cucumber核心类引用，和你使用的4.2.6版本Cucumber核心类结构不匹配，导致cucumber.runtime.RuntimeOptions未实现新版本要求的PluginOptions接口。
• Gherkin版本不匹配：Cucumber 4.2.6要求配套的Gherkin版本为5.x系列，你手动指定的gherkin:4.1.3结构不兼容，进一步加剧类冲突。
• TestNG版本适配问题：你使用的testng:7.4.0属于较新版本，Cucumber 4.x发布时TestNG最高稳定版本为6.x系列，二者集成组件存在适配缺陷。

方案1：兼容当前代码的低版本适配（无需调整现有TestRunner代码） #

所有Cucumber相关依赖统一使用4.8.1版本（4.x分支最后一个稳定版本，兼容性最佳），调整后核心依赖配置如下：

<properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
    <cucumber.version>4.8.1</cucumber.version>
    <testng.version>6.14.3</testng.version>
</properties>

<dependencies>
    <!-- Cucumber 官方依赖 -->
    <dependency>
        <groupId>io.cucumber</groupId>
        <artifactId>cucumber-java</artifactId>
        <version>${cucumber.version}</version>
    </dependency>
    <dependency>
        <groupId>io.cucumber</groupId>
        <artifactId>cucumber-testng</artifactId>
        <version>${cucumber.version}</version>
    </dependency>
    <!-- 移除手动引入的gherkin、cucumber-core、cucumber-jvm依赖，会自动传递引入匹配版本 -->
    
    <!-- 测试框架依赖 -->
    <dependency>
        <groupId>org.testng</groupId>
        <artifactId>testng</artifactId>
        <version>${testng.version}</version>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>io.appium</groupId>
        <artifactId>java-client</artifactId>
        <version>7.0.0</version>
    </dependency>
    <dependency>
        <groupId>org.seleniumhq.selenium</groupId>
        <artifactId>selenium-java</artifactId>
        <version>3.141.59</version>
    </dependency>
    
    <!-- 报告依赖建议移除或替换为适配4.8.1的版本，基础功能验证阶段可以先注释 -->
</dependencies>

调整后先执行mvn clean install清理旧依赖缓存，再运行TestNG用例即可。

方案2：升级到长期维护的Cucumber 7.x版本（推荐） #

目前Cucumber 7.x是官方维护的稳定版本，适配高版本TestNG，需要调整TestRunner的import路径：将所有cucumber.api开头的引用替换为io.cucumber开头，对应核心依赖配置如下：

<properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
    <cucumber.version>7.11.0</cucumber.version>
    <testng.version>7.4.0</testng.version>
</properties>

<dependencies>
    <!-- Cucumber 官方依赖 -->
    <dependency>
        <groupId>io.cucumber</groupId>
        <artifactId>cucumber-java</artifactId>
        <version>${cucumber.version}</version>
    </dependency>
    <dependency>
        <groupId>io.cucumber</groupId>
        <artifactId>cucumber-testng</artifactId>
        <version>${cucumber.version}</version>
    </dependency>
    
    <!-- 测试框架依赖 -->
    <dependency>
        <groupId>org.testng</groupId>
        <artifactId>testng</artifactId>
        <version>${testng.version}</version>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>io.appium</groupId>
        <artifactId>java-client</artifactId>
        <version>8.5.0</version>
    </dependency>
    <dependency>
        <groupId>org.seleniumhq.selenium</groupId>
        <artifactId>selenium-java</artifactId>
        <version>4.8.1</version>
    </dependency>
</dependencies>

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