已配置android.useAndroidX=true仍报AndroidX依赖未启用错误如何解决

• 首先确认gradle.properties存放路径正确：必须放在项目根目录下，不能放在module目录、用户全局Gradle配置目录，局部目录下的配置不会被项目构建逻辑优先读取。
• 核对基础配置兼容性
  • 项目根目录build.gradle中的Android Gradle插件版本（com.android.tools.build:gradle）需≥3.2.0，低于该版本不支持AndroidX相关属性配置
  • module级build.gradle中的compileSdk需≥28，AndroidX最低要求适配28及以上编译版本
• 排查依赖冲突
  • 全局搜索项目中是否存在硬编码的旧support包依赖，如com.android.support:appcompat-v7、com.android.support:design等，即使开启Jetifier，部分特殊引入的旧包也会触发检测异常，直接替换为对应的AndroidX依赖包
• 强制清理全链路缓存
  • 执行命令清理全局构建缓存：Mac/Linux运行./gradlew cleanBuildCache，Windows运行gradlew.bat cleanBuildCache
  • 重启Android Studio后重新执行Gradle同步
• 验证是否存在配置覆盖
  • 执行构建时手动带入参数：./gradlew assembleDebug -Pandroid.useAndroidX=true -Pandroid.enableJetifier=true，如果该命令可正常构建，说明存在子module、自定义构建脚本动态修改了android.useAndroidX属性，排查对应脚本即可。
• 核对IDE配置
  • 打开Android Studio设置路径：File > Settings > Build, Execution, Deployment > Build Tools > Gradle，确认「Gradle user home」路径配置正确，没有加载到带冲突配置的全局gradle.properties文件。

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