求助：Android开发遇IncompatibleClassChangeError，接口与类不匹配

这类错误的核心原因是依赖版本不一致或类/接口定义在不同依赖中发生了变更，以下是针对性解决步骤：

1. 统一所有Google Play Services依赖版本 #

Google Play Services的不同模块（如location、nearby）必须使用相同的主版本号，否则会出现类/接口定义冲突。

• 在模块级build.gradle（通常是app/build.gradle）中，确保所有com.google.android.gms开头的依赖版本统一：

dependencies {
    // 示例：统一使用21.0.1版本
    implementation 'com.google.android.gms:play-services-location:21.0.1'
    implementation 'com.google.android.gms:play-services-nearby:21.0.1'
    // 其他gms相关依赖也保持相同版本
}

• 更高效的方式是用版本变量管理，在项目级build.gradle中定义：

ext {
    gms_version = '21.0.1'
}

然后模块中引用：

implementation "com.google.android.gms:play-services-location:$gms_version"
implementation "com.google.android.gms:play-services-nearby:$gms_version"

2. 排查并排除冲突依赖 #

第三方库可能内置了旧版本的Google Play Services依赖，导致版本冲突。

• 执行Gradle命令查看依赖树：

./gradlew app:dependencies

• 找到冲突的com.google.android.gms模块，在第三方库依赖中添加排除规则：

implementation('第三方库坐标') {
    exclude group: 'com.google.android.gms'
}

3. 清理项目缓存并重建 #

缓存或旧构建产物可能残留不一致的类文件，需彻底清理：

• 点击Android Studio菜单栏：Build > Clean Project
• 接着执行：Build > Rebuild Project
• 若仍有问题，清除IDE缓存：File > Invalidate Caches...，勾选Clear file system cache and local history后点击Invalidate and Restart

4. 匹配SDK工具版本 #

打开Android Studio的SDK Manager，进入SDK Tools标签，确保Google Play Services的版本与依赖中声明的版本兼容，建议更新到最新稳定版。

5. 修正代码中的引用逻辑 #

部分Google Play Services类在版本迭代中会从类改为接口（或反之），检查代码中是否有错误的实例化方式：

• 例如ConnectionsClient如果是接口，应通过官方提供的入口方法获取实例：

ConnectionsClient client = Nearby.getConnectionsClient(context);

而非直接new ConnectionsClient()（如果旧版本是类时的写法）。

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