不同Java库重复类致编译错误：Appium Java Client兼容问题求解

我最近在使用Appium Java Client时碰到了一个棘手的兼容性问题，折腾了好一阵才找到可行的临时解决方案，在这里分享给大家：

问题根源 #

Appium Java Client（我使用的是6.1.0版本）的依赖中包含Selenium，但它内部部分复制了Selenium的org.openqa.selenium包，还对部分内部接口做了泛型修改。这就导致项目中出现同包同名的重复类，直接引发编译异常——比如WebElement接口会同时存在于Selenium和Appium的JAR包中，让编译器无法区分具体引用的是哪个类。

复现步骤 #

我搭建了一个简单的Gradle项目就能复现该问题：

1. build.gradle配置：

plugins { id 'java-library' }
dependencies { api 'io.appium:java-client:6.1.0' }
repositories { jcenter() }

2. 编写Interactions.java代码：

import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
public class Interactions {
    public static void touchWebElement(By by, WebDriver driver) {
        touchWebElement(driver.findElement(by), driver);
    }
    public static void touchWebElement(WebElement element, WebDriver driver) {
        // DO SOMETHING
    }
}

3. 编译时触发错误：

Interactions.java第8行，The method touchWebElement(By, WebDriver) is ambiguous for the type Interactions

这个错误的核心原因就是WebElement接口存在重复实例，导致编译器无法确定调用哪个重载方法。

尝试过的临时方案（均有局限性） #

• 降级Appium Client到<=4.0.0版本：这个版本没有复制Selenium的包，能正常运行，但我必须使用新版本的Appium功能，因此该方案不适用。
• 手动删除Appium包中的重复类：用7zip打开Appium的JAR包，删掉重复的org.openqa.selenium相关类，确实能消除编译错误，但手动修改依赖包的方式风险极高，后续可能引发未知的运行时问题，不推荐使用。

另外我查询了官方状态，当时Selenium和Appium官方都暂未修复该问题。

最终可行的适配方案 #

我想到了一个无需改动大量调用代码的折中办法：把方法参数改成Object类型，在方法内部做类型判断和转换。修改后的代码如下：

import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
public class Interactions {
    public static void touchWebElement(Object object, WebDriver driver){
        WebElement webElement = castObjectToWebElement(object, driver);
        // DO SOMETHING
    }
    private static WebElement castObjectToWebElement(Object object, WebDriver driver) {
        if (object instanceof WebElement) {
            return (WebElement) object;
        } else if (object instanceof By) {
            return driver.findElement((By) object);
        }
        throw new IllegalArgumentException("Invalid type");
    }
}

这个方案虽然不是最优雅的实现，但胜在不需要修改任何调用该方法的代码，且能正常编译运行，完美适配了当前的兼容性问题。

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