350 字
2 分钟
Java PKIX 问题

今天在调试Flutter真机时遇到了构建PKIX错误

错误内容如下:

Flutter assets will be downloaded from https://storage.flutter-io.cn. Make sure you trust this source!
Launching lib\main.dart on *** in debug mode...
Exception in thread "main" javax.net.ssl.SSLHandshakeException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target
at java.base/sun.security.ssl.Alert.createSSLException(Alert.java:131)
at java.base/sun.security.ssl.TransportContext.fatal(TransportContext.java:378)
at java.base/sun.security.ssl.TransportContext.fatal(TransportContext.java:321) ...
Caused by: sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target
at java.base/sun.security.validator.PKIXValidator.doBuild(PKIXValidator.java:439)
at java.base/sun.security.validator.PKIXValidator.engineValidate(PKIXValidator.java:306)
at java.base/sun.security.validator.Validator.validate(Validator.java:264)
at java.base/sun.security.ssl.X509TrustManagerImpl.checkTrusted(X509TrustManagerImpl.java:231)
at java.base/sun.security.ssl.X509TrustManagerImpl.checkServerTrusted(X509TrustManagerImpl.java:132)
at java.base/sun.security.ssl.CertificateMessage$T13CertificateConsumer.checkServerCerts(CertificateMessage.java:1335)
... 26 more
Caused by: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target
at java.base/sun.security.provider.certpath.SunCertPathBuilder.build(SunCertPathBuilder.java:148)
at java.base/sun.security.provider.certpath.SunCertPathBuilder.engineBuild(SunCertPathBuilder.java:129)
at java.base/java.security.cert.CertPathBuilder.build(CertPathBuilder.java:297)
at java.base/sun.security.validator.PKIXValidator.doBuild(PKIXValidator.java:434)
... 31 more
Error: Gradle task assembleDebug failed with exit code 1
App failed to start
Exited (1).

该报错在以前经常见到,例如

  • 在构建自己的Gradle项目时
  • 在使用Gradle构建的各类插件时

遇到这种问题确实很头疼,STFW也找了不少答案
接下来我提供几种我自己用到的方法

解决方法:使用国内镜像#

这是本人比较常用的方法
国内网络环境很多类似情况都可以通过使用国内镜像来解决

修改gradle-wrapper.properties
Flutter项目需要去这里找:\android\gradle\wrapper\gradle-wrapper.properties

例如:

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-9.3.1-all.zip

将distributionUrl改为镜像站的对应地址
如:

distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-9.3.1-all.zip
注意

不要直接将services.gradle.org段替换为镜像站点
建议进入镜像站一级级找


更多解决方法#

后续再遇到此类问题时再编写,如手动下载信任证书等等
未完待续…

Java PKIX 问题
https://fuwari.vercel.app/posts/java-pkix-problem/
作者
Acer
发布于
2026-10-07
许可协议
CC BY-NC-SA 4.0