未修改依赖却突发java.lang.NoClassDefFoundError: org/openqa/selenium/remote/html5/RemoteLocationContext问题的排查与方案咨询

我完全理解你遇到这种情况的困惑——明明没碰代码和依赖配置，之前运行好好的自动化测试突然炸了，这种“无厘头”的问题最让人头疼。先帮你理清楚整个问题的来龙去脉，再分析可能的原因和解决方案：

问题背景回顾 #

从2025年8月15日起，你的Appium自动化框架执行任何测试用例都会抛出以下错误：

Filename: specs\mobile_automation\passenger\revamp\smoke_tests\Ride\Ride\Rewrite\RideSmokeTestReWrite-01-General.spec
Message: java.lang.NoClassDefFoundError: org/openqa/selenium/remote/html5/RemoteLocationContext
Stack Trace:
java.lang.NoClassDefFoundError: org/openqa/selenium/remote/html5/RemoteLocationContext
at io.appium.java_client.AppiumDriver.(AppiumDriver.java:92)
at io.appium.java_client.AppiumDriver.(AppiumDriver.java:102)
at io.appium.java_client.android.AndroidDriver.(AndroidDriver.java:109)

当前你的pom.xml依赖配置为：

<dependency>
    <groupId>io.appium</groupId>
    <artifactId>java-client</artifactId>
    <version>9.4.0</version>
</dependency>
<dependency>
    <groupId>org.seleniumhq.selenium</groupId>
    <artifactId>selenium-java</artifactId>
    <version>4.19.1</version>
</dependency>

你已经排查出核心矛盾：RemoteLocationContext类在新版Selenium中被移除，但Appium Java Client 9.4.0仍在引用它，常规解决方向是升级Appium客户端或降级Selenium。但你疑惑的是为什么没改配置却突然出问题。

可能的突发原因分析 #

这种“无修改却故障”的情况，通常和依赖解析、缓存或环境变化有关，具体可能是以下几种情况：

1. 本地/CI环境的Maven缓存被清理或刷新 #

Maven会缓存下载的依赖包，之前你的环境中可能存在旧版本的Selenium相关JAR（比如某个传递依赖带来的低版本Selenium），缓存里的混合版本刚好掩盖了兼容性问题。当缓存被清理（比如CI环境重置、本地手动清理~/.m2/repository），Maven重新拉取你pom中指定的Selenium 4.19.1，就触发了Appium客户端与新版Selenium的类缺失冲突。

2. 传递依赖的隐性更新 #

虽然你没修改自己的pom，但如果项目中其他依赖使用了版本范围（比如[4.0,5.0)）而非固定版本，Maven可能在某次构建时拉取了该依赖的新版本，而这个新版本间接改变了Selenium相关传递依赖的解析优先级，导致原本被覆盖的兼容性问题暴露出来。

3. Appium/Selenium依赖的兼容性隐性变更 #

虽然Appium Java Client 9.4.0标注支持Selenium 4.x，但Selenium 4.19.1可能移除了一些之前版本保留的兼容类（比如RemoteLocationContext），而Appium 9.4.0的开发时并未覆盖到这个版本的测试，导致之前没问题，新版本Selenium发布后（刚好在8月15日前后？），你的环境拉取到新版就触发了故障。

解决方案建议 #

针对你的问题，我推荐按以下优先级尝试解决方案：

方案一：升级Appium Java Client到兼容Selenium 4.19.1的版本 #

这是最优解，因为升级能获得最新的功能、bug修复和兼容性支持。你可以查看Appium Java Client的官方Release Notes，找到明确适配Selenium 4.19+的版本（比如10.x系列的稳定版），替换pom中的版本号：

<dependency>
    <groupId>io.appium</groupId>
    <artifactId>java-client</artifactId>
    <version>10.2.0</version> <!-- 示例版本，以官方兼容说明为准 -->
</dependency>

升级后执行mvn clean install刷新依赖，验证测试是否恢复正常。

方案二：降级Selenium到Appium 9.4.0明确支持的版本 #

如果暂时无法升级Appium客户端，可以降级Selenium到Appium 9.4.0开发时对应的兼容版本。比如查看Appium Java Client 9.4.0的pom依赖，它指定的Selenium版本范围通常是4.18.x左右，你可以将selenium-java的版本改为4.18.1：

<dependency>
    <groupId>org.seleniumhq.selenium</groupId>
    <artifactId>selenium-java</artifactId>
    <version>4.18.1</version>
</dependency>

方案三：依赖排除（不推荐） #

如果以上两种方案都无法实施，你可以尝试排除Appium客户端中对旧Selenium模块的依赖，但这种方式风险较高，可能引发其他兼容性问题。示例配置如下：

<dependency>
    <groupId>io.appium</groupId>
    <artifactId>java-client</artifactId>
    <version>9.4.0</version>
    <exclusions>
        <exclusion>
            <groupId>org.seleniumhq.selenium</groupId>
            <artifactId>selenium-remote-driver</artifactId>
        </exclusion>
    </exclusions>
</dependency>

但请注意：这种方式只是强制使用你指定的Selenium版本，无法解决Appium代码中引用已移除类的本质问题，大概率还是会有其他报错，所以仅作为临时应急手段。

总结 #

核心问题还是Appium Java Client与Selenium版本的兼容性匹配问题，突发故障的原因大概率是缓存或依赖解析变化导致原本被隐藏的冲突暴露。优先推荐升级Appium客户端到最新兼容版本，既能解决当前问题，也能避免未来类似的兼容性陷阱。

内容来源于stack exchange