Ionic+Angular项目Gradle构建遇androidx.work重复类及依赖错误

问题根源 #

出现重复类错误是因为work-runtime和work-runtime-ktx版本不匹配，而后续的依赖解析失败则是由于版本强制写法错误导致gradle尝试解析不存在的拼接版本包。

具体解决方案 #

方案一：用WorkManager BOM统一版本（推荐）

Android WorkManager提供了物料清单（BOM）来自动统一所有work相关依赖的版本，彻底避免版本不一致问题：
在app级build.gradle的dependencies块中添加：

// 引入WorkManager BOM，统一管理所有work依赖版本
implementation platform('androidx.work:work-bom:2.8.1')
// 无需指定版本，BOM会自动匹配
implementation 'androidx.work:work-runtime'
implementation 'androidx.work:work-runtime-ktx'

方案二：强制指定所有work相关依赖版本

如果不想用BOM，直接在项目级build.gradle中统一强制版本：

allprojects {
    configurations.all {
        resolutionStrategy {
            force 'androidx.work:work-runtime:2.8.1'
            force 'androidx.work:work-runtime-ktx:2.8.1'
        }
    }
}

注意：不要把两个版本号拼在一起写，这是之前导致依赖解析失败的原因。

方案三：排查并排除冲突依赖

1. 执行命令查看完整依赖树，找到引入旧版本work-runtime-ktx:2.7.1的来源：

./gradlew app:dependencies

2. 在app级build.gradle中，对对应的依赖排除旧版本的work模块：

// 替换成实际引入冲突的依赖，比如某个Ionic插件
implementation('com.example:some-dependency:x.x.x') {
    exclude group: 'androidx.work', module: 'work-runtime-ktx'
}

3. 手动添加正确版本的work-runtime-ktx：

implementation 'androidx.work:work-runtime-ktx:2.8.1'

Ionic项目额外注意事项 #

• 如果是第三方Ionic插件引入的冲突，优先尝试更新插件到最新版本，多数插件会修复依赖版本问题。
• 执行清理命令清除构建缓存后重新构建：

# Cordova项目
ionic cordova clean android
# Capacitor项目
ionic capacitor clean android

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