gradle-wrapper.properties未被Gradle识别，Android项目构建报错求助

• 确认gradle.properties的位置与内容
  你添加的gradle.properties必须放在项目根目录（而非app模块子目录），且需同时配置两个核心属性：

  android.useAndroidX=true
  android.enableJetifier=true
  

  其中android.enableJetifier负责自动将旧Support库依赖迁移为AndroidX版本，仅开启useAndroidX可能无法完全解决依赖冲突。

• 检查Gradle插件与SDK版本配置
  打开项目根目录的build.gradle，确保Android Gradle插件版本不低于3.2.0（这是支持AndroidX的最低版本），示例配置：

  dependencies {
      classpath 'com.android.tools.build:gradle:7.4.2' // 可根据需求选择兼容的更高版本
  }
  

  同时检查app模块的build.gradle，确认compileSdkVersion和targetSdkVersion不低于30，且没有直接引用旧Support库（如com.android.support:appcompat-v7，需替换为androidx.appcompat:appcompat:1.6.1这类AndroidX依赖）。

• 清理缓存并强制同步项目

  1. 点击Android Studio顶部菜单File -> Invalidate Caches...，勾选Invalidate and Restart后重启IDE，彻底清除旧配置缓存。
  2. 重启完成后，点击File -> Sync Project with Gradle Files，强制同步最新配置。

• 验证Gradle wrapper版本兼容性
  打开gradle-wrapper.properties，确保Gradle版本与Android Gradle插件版本匹配（比如插件7.4.2对应Gradle 7.5版本），示例配置：

  distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-bin.zip
  

  版本不匹配会导致配置无法正常生效。

• 排查模块级配置覆盖问题
  检查app模块目录下是否存在gradle.properties文件，若存在，该文件的配置会覆盖根目录的全局配置，需确保其中同样设置了android.useAndroidX=true。

• 定位冲突依赖来源
  打开Android Studio终端，执行以下命令查看完整依赖树：

  ./gradlew app:dependencies
  

  在输出中找到debugRuntimeClasspath节点，排查是否有第三方依赖仍在引用旧Support库，可通过手动排除或替换为兼容AndroidX的版本解决。

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