升级至Android SDK 35、AGP 8.2.2及JDK 17后，Windows环境下AAPT2 TLS握手失败导致APK构建失败

阿华AIGC实验室

2026-3-31

兄弟，我太懂你这种升级环境卡几周的崩溃感了！你遇到的核心问题是AAPT2无法通过TLS协议从Google Maven仓库下载，结合你已经尝试的方法，我给你几个更针对性的解决步骤，按顺序试应该能搞定：

1. 扩展TLS协议支持范围

你之前只配置了TLSv1.2，但Google Maven仓库现在更偏好TLSv1.3，同时兼容两个版本能大幅降低握手失败概率：
打开项目根目录的gradle.properties文件，修改系统属性为：

systemProp.https.protocols=TLSv1.2,TLSv1.3

改完后点击Android Studio的「Sync Project with Gradle Files」，再尝试构建。

2. 确保Google Maven仓库配置正确且优先级最高

Gradle的仓库顺序会影响依赖下载，把Google仓库放在最前面能避免其他仓库干扰：

修改Project级别的build.gradle：

repositories {
    google() // 必须放在最前面
    mavenCentral()
    // 其他自定义仓库...
}

检查settings.gradle的依赖管理配置：

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
    }
}

3. 手动下载AAPT2并配置本地依赖

如果网络问题始终无法自动下载，直接手动指定本地AAPT2路径跳过网络请求：

找到对应AGP 8.2.2的AAPT2版本（aapt2-8.2.2-10154469）的Windows压缩包，解压后得到aapt2.exe

在Module级别的build.gradle里添加本地路径配置：

android {
    buildToolsVersion "35.0.0"
    aaptOptions {
        path "C:/你的解压路径/aapt2-8.2.2-10154469-windows/aapt2.exe"
    }
}

4. 彻底排查Windows代理与网络环境

Windows的自动代理、企业内网代理经常会悄咪咪干扰Gradle的网络请求：

打开Windows设置 → 网络和互联网 → 代理，关闭所有代理选项（包括自动检测、手动代理）
重启Android Studio和电脑，再尝试构建

如果是企业内网必须用代理，在gradle.properties里手动配置代理信息：

systemProp.http.proxyHost=你的代理地址
systemProp.http.proxyPort=代理端口
systemProp.https.proxyHost=你的代理地址
systemProp.https.proxyPort=代理端口
# 若代理需要认证，再添加以下两行
systemProp.http.proxyUser=你的代理账号
systemProp.http.proxyPassword=你的代理密码

5. 验证JDK 17的全局配置

确保Android Studio和Gradle都完全指向Temurin 17，没有残留旧JDK的配置：

打开File → Project Structure → SDK Location，确认JDK Location是Temurin 17的安装路径
在gradle.properties里手动指定JDK路径（避免系统默认JDK干扰）：
```
org.gradle.java.home=C:/Program Files/Eclipse Adoptium/jdk-17.0.18.7-hotspot
```
（路径替换成你自己的Temurin 17安装目录）

6. 临时降级AGP版本（备选方案）

如果以上方法都不行，可以先降级到兼容性更好的AGP版本过渡，等网络问题解决后再升级：

修改Project级别的build.gradle的AGP版本：

dependencies {
    classpath "com.android.tools.build:gradle:8.1.4"
}

修改gradle/wrapper/gradle-wrapper.properties的Gradle版本（AGP 8.1对应Gradle 8.0）：
```
distributionUrl=https\://services.gradle.org/distributions/gradle-8.0-bin.zip
```