Android Gradle Multidex问题：主classes.dex始终达65535引用上限无法压缩

我完全懂你现在的头疼——明明已经开了Multidex，也配了仅留小型Application类的保留文件，可主dex还是死死卡在65535的引用上限，没法兼容那个对主dex有严格要求的框架。我之前也踩过类似的坑，给你几个实操的方向试试：

• 先确认你的multidex-config.txt真的生效了
  很多时候问题出在配置细节上：

  • 检查build.gradle里的配置路径是否正确，要确保multiDexKeepFile指向的是你实际的文件位置，比如：

    android {
        defaultConfig {
            multiDexEnabled true
        }
        buildTypes {
            release {
                multiDexKeepFile file('multidex-config.txt')
                // debug环境如果也需要测试，别忘了同步配置
            }
        }
    }
    

  • 配置文件里的类路径格式要准确：得用斜杠代替点，还要带.class后缀，比如你的Application类是com.package.name.MyApp，文件里就得写com/package/name/MyApp.class。
  • 可以看构建日志验证：搜索multiDexKeepFile相关输出，确认配置文件被正确加载，以及哪些类被强制留在主dex里。

• 排查隐藏的强制主dex依赖
  有些第三方库、系统组件甚至Gradle默认规则，会偷偷把大量类塞进主dex：

  • 生成主dex依赖报告分析：在终端运行./gradlew app:createMainDexClassList（把app换成你的模块名），报告在build/intermediates/multi-dex/<variant>/mainDexList.txt里，打开看看哪些是你没配置却被强制保留的类。
  • 检查ProGuard规则：有没有类似-keep class com.yourpackage.** { *; }的通配符规则，这种会把整个包锁在主dex里，得调整成只保留必要的类。

• 调整dexOptions优化参数
  试试让Gradle更智能地拆分dex：

  android {
      dexOptions {
          preDexLibraries false // 禁止预编译依赖库dex，让Gradle重新整合所有类
          javaMaxHeapSize "4g" // 加大堆内存，避免构建OOM，也有助于更优的拆分逻辑
          jumboMode true // 允许单个dex容纳更多方法引用，可临时缓解上限问题
      }
  }
  

• 手动把非核心依赖移出主dex
  如果上面的方法都不行，就主动把非必要的类排除出主dex：

  • 创建一个ProGuard规则文件（比如multidex-exclude.pro），把不需要在启动时加载的库写进去：

    -dontkeep com.glide.** { *; }
    -dontkeep com.retrofit.** { *; }
    

  • 在build.gradle里配置引用这个规则：

    android {
        buildTypes {
            release {
                multiDexKeepProguard file('multidex-exclude.pro')
            }
        }
    }
    

  ⚠️ 注意：一定要确保这些被排除的类不会在Application.onCreate()或其他启动流程中被调用，否则会触发ClassNotFoundException。

• 核对框架的具体要求
  有些框架的"包裹主classes.dex"可能有特殊规则，比如要求主dex必须包含框架自身的核心类。去翻框架文档，看看有没有明确的主dex保留列表，把这些类也加入你的multidex-config.txt里，再把其他类全部拆分出去。

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