讲师中心 微信公众号
AI工具推荐 视频效率加速

Maven 依赖解析失败的常见原因与完整解决方案

风磊吖_1423

风磊吖_1423

发布时间:2026-03-01 19:37:02

|

412人浏览过

|

来源于php中文网

原创

Maven 依赖解析失败的常见原因与完整解决方案

本文详解 Maven 构建中“Failed to collect dependencies”错误的根源,重点解决因仓库配置不当(如混淆 repositories 与 pluginRepositories、缺失 Spring 相关仓库或 HTTP 镜像拦截)导致的依赖无法解析问题,并提供标准化、安全可用的 pom.xml 和 settings.xml 配置方案。

本文详解 maven 构建中“failed to collect dependencies”错误的根源,重点解决因仓库配置不当(如混淆 `repositories` 与 `pluginrepositories`、缺失 spring 相关仓库或 http 镜像拦截)导致的依赖无法解析问题,并提供标准化、安全可用的 `pom.xml` 和 `settings.xml` 配置方案。

在使用 Maven 构建 Spring Boot 项目(尤其是预发布版本如 2.3.0.RC1)时,常遇到类似以下错误:

Failed to collect dependencies at org.springframework.boot:spring-boot-starter-oauth2-client:jar:2.3.0.RC1
→ org.springframework.security:spring-security-oauth2-client:jar:5.3.1.RELEASE
→ com.nimbusds:oauth2-oidc-sdk:jar:7.1.1
→ com.nimbusds:nimbus-jose-jwt:jar:8.8
→ net.minidev:json-smart:jar:[1.3.1,2.3]: No versions available for net.minidev:json-smart:jar:[1.3.1,2.3] within specified range

该错误表面是 net.minidev:json-smart 版本范围无法满足,实则根本原因是 Maven 无法从任何有效仓库获取该依赖——而根源往往在于仓库配置策略失当。

? 核心问题定位

  1. pluginRepositories ≠ repositories
    pluginRepositories 仅用于解析 Maven 插件(如 maven-compiler-plugin),而普通项目依赖(如 spring-boot-starter-*、nimbus-jose-jwt)必须通过 声明的仓库下载。您当前 pom.xml 中仅将 spring-milestones 配置在 下,导致 Spring 生态的 release/milestone 依赖(包括其传递依赖 json-smart)完全不可见。

  2. settings.xml 中的 HTTP 拦截镜像生效
    您的 settings.xml 包含如下强制拦截配置:

    <mirror>
      <id>maven-default-http-blocker</id>
      <mirrorOf>external:http:*</mirrorOf>
      <url>http://0.0.0.0/</url>
      <blocked>true</blocked>
    </mirror>

    此配置会主动阻断所有 http:// 协议仓库(即使 pom.xml 中未显式声明)。而部分旧版 Spring 仓库(如 http://repo.spring.io/release)仍使用 HTTP,若未在 pom.xml 中显式启用 HTTPS 替代,或未在 settings.xml 中排除该镜像,将直接导致依赖拉取失败。

  3. 缺少关键仓库覆盖范围
    Spring 官方依赖(尤其是 RC、milestone、snapshot 版本)分散在多个专用仓库:

    • https://repo.spring.io/snapshot(快照版)
    • https://repo.spring.io/milestone(里程碑版)
    • https://repo.spring.io/release(正式 GA 版,推荐 HTTPS)

    仅配置中央仓库(https://repo.maven.apache.org/maven2)不足以覆盖 Spring 生态全生命周期依赖。

✅ 推荐解决方案:完整仓库配置

请将以下配置同时更新至您的 pom.xml(注意: 与 必须成对补充,且 URL 统一使用 HTTPS):

<repositories>
  <!-- Spring Snapshots -->
  <repository>
    <id>spring-snapshots</id>
    <name>Spring Snapshots</name>
    <url>https://repo.spring.io/snapshot</url>
    <snapshots><enabled>true</enabled><updatePolicy>always</updatePolicy></snapshots>
    <releases><enabled>false</enabled></releases>
  </repository>
  <!-- Spring Milestones -->
  <repository>
    <id>spring-milestones</id>
    <name>Spring Milestones</name>
    <url>https://repo.spring.io/milestone</url>
    <snapshots><enabled>false</enabled></snapshots>
    <releases><enabled>true</enabled></releases>
  </repository>
  <!-- Spring GA (Release) -->
  <repository>
    <id>spring-releases</id>
    <name>Spring Releases</name>
    <url>https://repo.spring.io/release</url>
    <snapshots><enabled>false</enabled></snapshots>
    <releases><enabled>true</enabled><updatePolicy>never</updatePolicy></releases>
  </repository>
  <!-- Central Repository (fallback) -->
  <repository>
    <id>central</id>
    <name>Maven Central</name>
    <url>https://repo.maven.apache.org/maven2</url>
    <snapshots><enabled>false</enabled></snapshots>
  </repository>
</repositories>

<pluginRepositories>
  <!-- 对应插件仓库(确保插件也能解析) -->
  <pluginRepository>
    <id>spring-snapshots</id>
    <name>Spring Snapshots</name>
    <url>https://repo.spring.io/snapshot</url>
    <snapshots><enabled>true</enabled></snapshots>
    <releases><enabled>false</enabled></releases>
  </pluginRepository>
  <pluginRepository>
    <id>spring-milestones</id>
    <name>Spring Milestones</name>
    <url>https://repo.spring.io/milestone</url>
    <snapshots><enabled>false</enabled></snapshots>
    <releases><enabled>true</enabled></releases>
  </pluginRepository>
  <pluginRepository>
    <id>spring-releases</id>
    <name>Spring Releases</name>
    <url>https://repo.spring.io/release</url>
    <snapshots><enabled>false</enabled></snapshots>
    <releases><enabled>true</enabled></releases>
  </pluginRepository>
</pluginRepositories>

⚠️ 重要提醒:

  • 所有 Spring 仓库 URL 必须使用 https://(非 http://),否则会被 maven-default-http-blocker 拦截;
  • 若您确需保留 settings.xml 中的 HTTP 拦截镜像,请在 外添加 或直接移除该镜像(Maven 3.8.1+ 默认启用此 blocker,但现代项目应全面转向 HTTPS);
  • spring-boot-starter-oauth2-client:2.3.0.RC1 属于已废弃的旧版预发布包,强烈建议升级至稳定版(如 3.2.x 或 3.3.x),以避免兼容性与仓库支持问题。

? 验证与调试技巧

执行以下命令清理缓存并强制更新依赖,验证修复效果:

mvn clean dependency:purge-local-repository -DreResolve=false
mvn compile -U

若仍报错,可启用详细日志定位具体哪个依赖卡住:

mvn compile -X 2>&1 | grep -A5 -B5 "json-smart"

✅ 总结

Maven 依赖解析失败,90% 源于仓库配置不完整或协议不匹配。正确做法是:

  • ✅ 将 Spring 相关依赖仓库(snapshot/milestone/release)统一声明在 ;
  • ✅ 对应插件仓库声明在 ;
  • ✅ 全面采用 https:// 协议,规避 maven-default-http-blocker 干扰;
  • ✅ 优先选用 Spring Boot 官方推荐的稳定版本,减少对预发布仓库的依赖。

遵循上述配置后,net.minidev:json-smart 等传递依赖将自动从 https://repo.spring.io/release 或中央仓库成功解析,构建流程恢复正常。

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

讯飞智文

一款面向学习和办公场景的AI文档创作工具,可辅助生成PPT与Word文档,提高资料整理和内容制作效率。

相关专题

更多
Java Maven专题
Java Maven专题

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

4460

2025.09.15

Java Maven/Gradle 构建与依赖管理合集
Java Maven/Gradle 构建与依赖管理合集

系统讲解 Java 项目构建工具的使用与进阶配置,涵盖 Maven 的 POM 文件结构、生命周期(clean/compile/package/install/deploy)与插件机制、依赖范围(compile/provided/test/runtime)与传递依赖管理、多模块聚合与继承、私有 Nexus 仓库发布,以及 Gradle 的 Groovy / Kotlin DSL 语法、Task 自定义与增量构建、依赖版本目录(Versi

389

2026.05.09

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

20

2026.11.05

DBeaver安全防护教程大全
DBeaver安全防护教程大全

DBeaver安全防护专题,围绕数据库连接安全、账号密码保护和访问权限管理展开,整理SSL/TLS加密连接、SSH隧道、数据库凭据保存及证书验证等配置方法,同时介绍敏感信息保护、远程连接风险和高权限账号使用等注意事项,帮助用户提高数据库日常管理的安全性。

20

2026.11.05

DBeaver连接创建与配置教程
DBeaver连接创建与配置教程

本专题聚焦DBeaver数据库连接配置与管理,覆盖从新建连接、选择数据库类型到填写连接参数和验证连接的完整流程。针对MySQL、PostgreSQL、SQL Server等常见数据库,整理相应的连接设置方法,并提供驱动缺失、认证失败和连接异常等问题的排查方向。

20

2026.11.04

XORM框架结构体映射与表结构同步
XORM框架结构体映射与表结构同步

本专题围绕XORM框架的结构体映射展开,说明表名与字段的命名策略、xorm标签常用属性、主键自增与时间字段自动填充,并演示Sync2自动建表、增量字段升级、索引声明与反向生成结构体的完整流程。

20

2026.11.04

XORM框架安装配置与数据库连接
XORM框架安装配置与数据库连接

本专题聚焦XORM框架的配置与连接环节,拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择,讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式,并补充容器与兼容数据库的适配经验。

20

2026.11.04

XORM框架安装配置与数据库连接
XORM框架安装配置与数据库连接

本专题聚焦XORM框架的配置与连接环节,拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择,讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式,并补充容器与兼容数据库的适配经验。

0

2026.11.04

XORM框架安装配置与数据库连接
XORM框架安装配置与数据库连接

本专题聚焦XORM框架的配置与连接环节,拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择,讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式,并补充容器与兼容数据库的适配经验。

0

2026.11.04

热门下载

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

精品课程

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn