解决 Gradle 错误：Could not find androidx.appcompat:appcompat:1.7.1

Could not resolve all dependencies for configuration ':app:debugRuntimeClasspath'.
Could not find androidx.appcompat:appcompat:1.7.1.
Searched in the following locations:
        

问题分析

从错误日志可以看到，Gradle 只在以下位置搜索：

• 本地 .m2 仓库
• 阿里云镜像
• Maven 中央仓库

但没有搜索 Google 仓库！ 这就是问题所在。

解决方案

1. 确保 Google 仓库配置正确

在项目根目录的 build.gradle 中：

allprojects {
    repositories {
        google() // 必须在前面！
        mavenCentral()
        maven { url 'https://maven.aliyun.com/repository/public' }
    }
}

或者如果使用 settings.gradle (较新的 Gradle 版本)：

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google() // 必须包含！
        mavenCentral()
        maven { url 'https://maven.aliyun.com/repository/public' }
    }
}

2. 如果网络问题，使用阿里云的 Google 镜像

allprojects {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' } // Google 镜像
        maven { url 'https://maven.aliyun.com/repository/central' } // Central 镜像
        google() // 备用
        mavenCentral() // 备用
    }
}

3. 检查是否有仓库过滤或排除设置

# 删除这类可能干扰仓库访问的设置
# android.enableR8.fullMode=true

4. 强制刷新依赖

./gradlew clean --refresh-dependencies
./gradlew build

5. 验证版本存在性

手动验证该版本确实存在：Google 仓库

6. 临时使用其他版本

implementation 'androidx.appcompat:appcompat:1.7.0'
// 或
implementation 'androidx.appcompat:appcompat:1.6.1'