You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Android Studio构建应用时出现Unable to merge dex错误求助

解决Android Studio中"Unable to merge dex"问题的实用排查方案

我之前也踩过这个dex合并的坑,尤其是用通配符版本号的时候特别容易出问题,结合你的配置情况,给你几个针对性的排查方向:

  • 锁定Support Library的具体版本
    你用的$supportVersion = '26.+'这种通配符会让Gradle自动拉取26系列的最新子版本,但不同依赖可能会拉到不同的小版本(比如26.0.1和26.1.0),这是引发dex冲突的高频原因。建议把版本号固定成具体值,比如26.1.0,然后重新同步项目。

  • 检查依赖树里的重复/冲突库
    打开终端,在项目根目录执行命令:

    # Mac/Linux
    ./gradlew app:dependencies
    # Windows
    gradlew.bat app:dependencies
    

    查看生成的依赖树,重点找有没有重复引入的库——比如不同模块都引入了同一个库的不同版本,或者某个第三方库内部已经包含了Support Library的部分模块,和你手动引入的产生冲突。找到冲突项后,可以用exclude group: 'com.android.support'来排除重复的依赖。

  • 彻底清理缓存后重构
    常规的clean & rebuild有时候不够彻底,试试这些操作:

    • 打开Android Studio,选择File → Invalidate Caches / Restart,点击Invalidate and Restart清除IDE缓存
    • 删除项目根目录的.gradle文件夹,以及app模块下的build文件夹,然后重新同步Gradle
  • 确认MultiDex配置完整
    你已经加了multiDexEnabled true,但还要注意:

    • 如果你的minSdkVersion低于21,需要让你的Application类继承MultiDexApplication,或者在attachBaseContext方法里调用MultiDex.install(this)
    • 确保已经添加MultiDex的依赖:implementation 'com.android.support:multidex:1.0.3'(这个版本和26.x的Support Library适配)
  • 排查第三方库的兼容性
    有些旧版本的第三方SDK(比如广告、统计类)可能和26.x的Support Library不兼容。可以尝试暂时移除最近添加的第三方依赖,看问题是否消失,逐步定位出冲突的库。

内容的提问来源于stack exchange,提问作者Marcus Twichel

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.20 10:02:58