Android Studio 3构建旧项目报错：无法合并dex，求解决方案

Hey there, let's work through this dex merging headache you're having with your old Android project. I know it's frustrating when the go-to multiDexEnabled true fix doesn't resolve the issue right away—let's break down some common fixes that might get your build back on track.

1. Hunt Down Duplicate Dependencies #

This is the #1 culprit for dex merging errors. Different libraries might be pulling in conflicting versions of the same dependency. To spot this:

• Run this command in your project root to generate a full dependency tree:

  ./gradlew app:dependencies
  

• Look for entries where the same library appears with multiple versions. For example, if two libraries depend on different versions of support-v4, exclude the redundant one in your build.gradle:

  implementation('com.example.somelibrary:1.2.3') {
      exclude group: 'com.android.support', module: 'support-v4'
  }
  

2. Clean & Rebuild (Yes, Really) #

Build caches can sometimes hold onto corrupted files that cause weird dex issues. Try these steps:

• In Android Studio: Go to Build > Clean Project, then Build > Rebuild Project
• Or via command line:

  ./gradlew clean assembleDebug
  

3. Ensure MultiDex is Fully Set Up (For minSdk < 21) #

If your minSdkVersion is below 21, just enabling multiDexEnabled true isn't enough. You need to:

• Add the MultiDex dependency to your app-level build.gradle:

  implementation 'com.android.support:multidex:1.0.3'
  

• Update your Application class:
  Either extend MultiDexApplication:

  public class MyApp extends MultiDexApplication {
      // ... your existing code
  }
  

  Or if you can't extend it, override attachBaseContext:

  public class MyApp extends Application {
      @Override
      protected void attachBaseContext(Context base) {
          super.attachBaseContext(base);
          MultiDex.install(this);
      }
  }
  

• Don't forget to reference this class in your AndroidManifest.xml:

  <application
      android:name=".MyApp"
      <!-- ... other attributes -->
  >
  

4. Fix Build Tools & Compile SDK Compatibility #

Your build.gradle shows buildToolsVersion = Syste... (looks like it got truncated). Make sure your buildToolsVersion is compatible with your compileSdkVersion (26 in your case). For example, use 26.0.2 or a later compatible version—avoid using outdated build tools.

5. Disable Build Cache (Temporary Test) #

Sometimes the Android build cache causes unexpected issues. Add this line to your gradle.properties file:

android.enableBuildCache=false

Then clean and rebuild again to see if the error goes away.

6. Check for Annotation Processor Conflicts #

If you're using annotation processors (like ButterKnife, Dagger, or Room), mismatched versions or duplicate processor dependencies can break dex merging. Ensure all processor versions align with your other dependencies, and exclude any redundant processor imports if needed.

If none of these fixes work, sharing your full app-level build.gradle file and the complete output of ./gradlew app:dependencies would help narrow down the exact conflict.

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