如何解决Android Studio升级play-services-ads后出现的Duplicate class错误

架构老林

2026-10-2

问题原因

重复类报错是因为com.google.android.gms:play-services-ads:20.4.0依赖的play-services-measurement系列组件存在版本冲突，同时引入了18.0.2和18.0.3两个版本，不同版本里存在同路径的类导致编译失败。

修复方案

方案1：强制统一依赖版本（推荐）

在app模块的build.gradle文件中，添加全局版本强制规则，将所有冲突的测量组件统一指定为18.0.3版本：

configurations.all {
    resolutionStrategy {
        force 'com.google.android.gms:play-services-measurement:18.0.3'
        force 'com.google.android.gms:play-services-measurement-base:18.0.3'
        force 'com.google.android.gms:play-services-measurement-impl:18.0.3'
        force 'com.google.android.gms:play-services-measurement-sdk-api:18.0.3'
    }
}

该方案不需要修改原有依赖声明，适用性最强，不会影响其他功能。

方案2：从广告依赖中排除冲突组件

如果项目中完全没有使用Google测量、Firebase分析相关的功能，可以直接在广告依赖声明时排除掉冲突的测量组件：

implementation ('com.google.android.gms:play-services-ads:20.4.0') {
    exclude group: 'com.google.android.gms', module: 'play-services-measurement'
    exclude group: 'com.google.android.gms', module: 'play-services-measurement-base'
    exclude group: 'com.google.android.gms', module: 'play-services-measurement-impl'
    exclude group: 'com.google.android.gms', module: 'play-services-measurement-sdk-api'
}

注意：如果项目其他地方依赖了上述测量组件，该方案可能会导致运行时异常，请谨慎使用。