You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Flutter Gradle构建报错求助:无法解析com.android.tools.build:gradle:8.1.2

Flutter Gradle构建失败(证书/TLS问题)解决办法

针对你遇到的Gradle无法下载依赖、提示TLS协议和PKIX证书路径错误的问题,试试以下方案:

1. 升级JDK到17版本

Gradle 8.x系列要求JDK 17支持,低版本JDK可能导致TLS握手和证书验证失败:

  • 推荐使用Android Studio自带的JDK:打开Android Studio,进入File > Project Structure > SDK Location,在JDK location选择Studio自带的JDK(通常路径是Android Studio/jbr)。
  • 手动安装OpenJDK 17后,可在项目的android/gradle.properties中添加:
    org.gradle.java.home=/path/to/your/jdk17
    

2. 手动导入SSL证书到JDK信任库

如果是证书信任问题,手动下载并导入Google和Maven仓库的根证书:

  1. 打开浏览器访问https://dl.google.com和https://repo.maven.apache.org,导出站点的根证书(保存为.cer格式)。
  2. 打开终端/命令提示符,执行以下命令导入证书(默认信任库密码为changeit):
    # 导入Google证书
    keytool -importcert -file /path/to/google_root.cer -keystore $JAVA_HOME/jre/lib/security/cacerts -alias google_maven_cert
    # 导入Maven证书
    keytool -importcert -file /path/to/maven_root.cer -keystore $JAVA_HOME/jre/lib/security/cacerts -alias maven_central_cert
    
    Windows系统替换$JAVA_HOME为你的JDK安装路径,比如C:\Program Files\Java\jdk-17。

3. 切换Gradle仓库为国内镜像

如果是网络访问受限导致的下载失败,修改项目android/build.gradle文件,替换仓库地址为国内镜像:

buildscript {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/public' }
        maven { url 'https://maven.aliyun.com/repository/gradle-plugin' }
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:8.1.2'
    }
}

allprojects {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/public' }
    }
}

4. 清除Gradle缓存后重新构建

缓存损坏也可能导致依赖解析失败,执行以下操作:

# 清除Flutter项目缓存
flutter clean
# 清除本地Gradle缓存(Linux/Mac)
rm -rf ~/.gradle/caches
# Windows系统执行
rd /s /q %USERPROFILE%\.gradle\caches

完成后重新运行flutter run尝试构建。

内容的提问来源于stack exchange,提问作者Priyanshu Bhandari

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.06 20:42:45