Android Support转AndroidX后Dagger依赖类失效及编译报错

排查方向与修复步骤 #

1. 彻底清理Support库残留依赖 #

迁移到AndroidX后，未替换的Support库依赖很可能和Dagger产生冲突：

• 运行 ./gradlew app:dependencies 查看完整依赖树，找出所有com.android.support开头的依赖项。
• 在app/build.gradle中添加强制替换规则，将Support库替换为对应AndroidX版本：

  configurations.all {
      resolutionStrategy {
          // 替换为你项目适配的AndroidX版本
          force 'androidx.core:core-ktx:1.10.1'
          force 'androidx.appcompat:appcompat:1.6.1'
          // 排除所有Support库依赖
          exclude group: 'com.android.support'
      }
  }
  

2. 清理编译缓存，重新生成Dagger代码 #

旧的编译缓存会残留Support库相关代码，导致依赖解析错误：

• 执行命令彻底清理缓存：

  ./gradlew clean
  ./gradlew :app:assembleDebug --no-build-cache
  

• 手动删除项目根目录的.gradle文件夹和app/build文件夹，再重新同步Gradle。

3. 检查Dagger代码的AndroidX适配问题 #

Dagger注解处理器会因代码引用旧Support类触发报错：

• 检查所有@Module、@Inject相关类，确保用到的组件（如Fragment、Context）都是AndroidX版本，比如用androidx.fragment.app.Fragment替代android.support.v4.app.Fragment。
• 排查循环依赖：比如Module依赖Component提供的实例，Component又依赖该Module，这种情况需重构代码拆分依赖关系。
• 确认所有@Inject构造函数的参数都能被Dagger正确提供，无缺失依赖。

4. 升级Dagger到兼容AndroidX的新版本 #

2.28.3版本对AndroidX的支持不够完善，建议升级到最新稳定版（如2.50）：

// Dagger核心依赖
implementation 'com.google.dagger:dagger:2.50'
annotationProcessor 'com.google.dagger:dagger-compiler:2.50'
// 若使用Dagger Android扩展
implementation 'com.google.dagger:dagger-android:2.50'
implementation 'com.google.dagger:dagger-android-support:2.50'
annotationProcessor 'com.google.dagger:dagger-android-processor:2.50'

注意：Kotlin项目需将annotationProcessor替换为kapt

5. 对齐Gradle插件与JDK版本 #

版本不兼容会导致注解处理器工作异常：

• 确保Gradle插件版本与Target SDK匹配，比如Gradle插件7.4+搭配Target SDK 33会更稳定。
• 将项目编译的JDK版本设置为11或更高：

  android {
      compileOptions {
          sourceCompatibility JavaVersion.VERSION_11
          targetCompatibility JavaVersion.VERSION_11
      }
      // Kotlin项目额外配置
      kotlinOptions {
          jvmTarget = "11"
      }
  }
  

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