0

0

Maven 构建时 PKIX 证书验证失败的解决方案

碧海醫心

碧海醫心

发布时间:2026-01-02 12:20:03

|

658人浏览过

|

来源于php中文网

原创

Maven 构建时 PKIX 证书验证失败的解决方案

maven 3.9+ 默认启用基于 java 的安全 https 传输(aether.connector.https.securitymode=secure),导致无法验证 maven 中央仓库证书时抛出 pkix path building failed 错误;本文提供安全、兼容且可复用的修复方法。

该错误本质是 Maven 客户端在尝试通过 HTTPS 访问 https://www.php.cn/link/75f5a325280e4f8d8402d0300e9da4f7 时,无法构建有效的 TLS 证书信任链(PKIX path building failed),常见于企业代理、本地网络中间设备(如防火墙、SSL 解密网关)或 JDK 信任库缺失/过期证书场景。

虽然手动导入证书到 cacerts 是传统做法,但自 Maven 3.9 起,其默认传输层已切换为更严格的 native HTTP connector(基于 JDK 的 HttpsURLConnection),不再完全依赖系统级 cacerts,而是额外执行 RFC 5280 合规性校验。因此,仅导入证书往往无效。

✅ 推荐解决方案:临时禁用传输层 SSL 验证(开发/测试环境适用)
使用 Maven 属性覆盖安全模式,跳过证书链验证:

mvn compile -Daether.connector.https.securityMode=insecure

该参数明确告知 Maven 使用非严格安全模式,适用于以下场景:

Q.AI视频生成工具
Q.AI视频生成工具

支持一分钟生成专业级短视频,多种生成方式,AI视频脚本,在线云编辑,画面自由替换,热门配音媲美真人音色,更多强大功能尽在QAI

下载
  • 本地开发调试(非生产)
  • 受控内网环境(如公司代理强制 SSL 拦截)
  • 快速验证是否为证书问题(诊断用途)

⚠️ 注意事项:

  • 不建议在 CI/CD 或生产构建中长期启用 insecure 模式,会削弱传输安全性;
  • 若需长期解决,应优先修复根本原因:更新 JDK 的 cacerts(keytool -importcert 导入权威 CA 或中间证书),或配置企业代理的可信根证书;
  • 对于 Maven 全局生效,可将该属性添加至 ~/.m2/settings.xml 的 中(但需谨慎评估安全影响);
  • 确保使用的是 Maven 3.9+(可通过 mvn -v 验证),旧版本不支持该参数。

? 补充验证方式:
运行以下命令确认是否为传输层问题:

mvn dependency:resolve -Dartifact=org.junit:junit-bom:pom:5.6.2 -X 2>&1 | grep -i "securitymode\|https"

输出中若出现 securityMode=secure 且紧随 ValidatorException,即确认为此机制触发。

总结:-Daether.connector.https.securityMode=insecure 是 Maven 3.9+ 下应对 PKIX 证书路径失败最直接、低侵入的临时方案;但真正健壮的工程实践,仍应回归证书信任体系治理——定期同步 JDK CA 仓库、统一管理企业根证书、避免中间设备无差别 SSL 解密。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
Java Maven专题
Java Maven专题

本专题聚焦 Java 主流构建工具 Maven 的学习与应用,系统讲解项目结构、依赖管理、插件使用、生命周期与多模块项目配置。通过企业管理系统、Web 应用与微服务项目实战,帮助学员全面掌握 Maven 在 Java 项目构建与团队协作中的核心技能。

0

2025.09.15

pdf怎么转换成xml格式
pdf怎么转换成xml格式

将 pdf 转换为 xml 的方法:1. 使用在线转换器;2. 使用桌面软件(如 adobe acrobat、itext);3. 使用命令行工具(如 pdftoxml)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1944

2024.04.01

xml怎么变成word
xml怎么变成word

步骤:1. 导入 xml 文件;2. 选择 xml 结构;3. 映射 xml 元素到 word 元素;4. 生成 word 文档。提示:确保 xml 文件结构良好,并预览 word 文档以验证转换是否成功。想了解更多xml的相关内容,可以阅读本专题下面的文章。

2118

2024.08.01

xml是什么格式的文件
xml是什么格式的文件

xml是一种纯文本格式的文件。xml指的是可扩展标记语言,标准通用标记语言的子集,是一种用于标记电子文件使其具有结构性的标记语言。想了解更多相关的内容,可阅读本专题下面的相关文章。

1162

2024.11.28

apache是什么意思
apache是什么意思

Apache是Apache HTTP Server的简称,是一个开源的Web服务器软件。是目前全球使用最广泛的Web服务器软件之一,由Apache软件基金会开发和维护,Apache具有稳定、安全和高性能的特点,得益于其成熟的开发和广泛的应用实践,被广泛用于托管网站、搭建Web应用程序、构建Web服务和代理等场景。本专题为大家提供了Apache相关的各种文章、以及下载和课程,希望对各位有所帮助。

419

2023.08.23

apache启动失败
apache启动失败

Apache启动失败可能有多种原因。需要检查日志文件、检查配置文件等等。想了解更多apache启动的相关内容,可以阅读本专题下面的文章。

938

2024.01.16

Java 流式处理与 Apache Kafka 实战
Java 流式处理与 Apache Kafka 实战

本专题专注讲解 Java 在流式数据处理与消息队列系统中的应用,系统讲解 Apache Kafka 的基础概念、生产者与消费者模型、Kafka Streams 与 KSQL 流式处理框架、实时数据分析与监控,结合实际业务场景,帮助开发者构建 高吞吐量、低延迟的实时数据流管道,实现高效的数据流转与处理。

134

2026.02.04

http500解决方法
http500解决方法

http500解决方法有检查服务器日志、检查代码错误、检查服务器配置、检查文件和目录权限、检查资源不足、更新软件版本、重启服务器或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

494

2023.11.09

JavaScript浏览器渲染机制与前端性能优化实践
JavaScript浏览器渲染机制与前端性能优化实践

本专题围绕 JavaScript 在浏览器中的执行与渲染机制展开,系统讲解 DOM 构建、CSSOM 解析、重排与重绘原理,以及关键渲染路径优化方法。内容涵盖事件循环机制、异步任务调度、资源加载优化、代码拆分与懒加载等性能优化策略。通过真实前端项目案例,帮助开发者理解浏览器底层工作原理,并掌握提升网页加载速度与交互体验的实用技巧。

23

2026.03.06

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Kotlin 教程
Kotlin 教程

共23课时 | 4.2万人学习

C# 教程
C# 教程

共94课时 | 10.9万人学习

Java 教程
Java 教程

共578课时 | 78.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号