Maven Dependency 下载失败问题

前言

在使用Maven私服Sonatype Nexus的时候,经常会出现依赖包找不到的问题.

此时通过浏览器去私服页面查看,发现依赖包坐标是存在的,对应的文件(比如jar文件).  

或者私服上面也找不到文件,但是引入的中央仓库或者其他公服上面有文件.

@Author duangr

@Website http://my.oschina.net/duangr/blog/182134

1.问题描述

在通过pom.xml中的依赖坐标,从私服下载依赖包时,往往会遇到如下的类似问题:

The container 'Maven Dependencies' references non existing library '${groupid}/${artifactid}-${version}.jar'

e.g.

1
The container 'Maven Dependencies' references non existing library 'E:\Maven\repo\org\apache\hadoop\hadoop-yarn-api\2.0.0-cdh4.5.0\hadoop-yarn-api-2.0.0-cdh4.5.0.jar'

2.解决方案

上面问题往往是在下载依赖过程中网络出现问题导致的.

此时我们本机已经开始下载依赖代码,但是下载失败,本机仓库中会在${MAVEN_repo}/${groupid}/${artifactid}/${version} 路径下面生成 *.lastUpdated 的文件.

*.lastUpdated实在可恶,下次再下载时由于它的存在Maven不会再去私服中下载

2.1 解决方法:(针对PC与Maven私服之间网络传输问题)

  1. 打开本地仓库所在目录, 通过win文件夹的搜索功能,查找 *.lastUpdated ,然后将找到的文件全部删除

  2. 重新 Maven Update Project,

    1. 若在eclipse中操作时勾选上 Force Update of Snapshots / Releases

    2. 若在命令行操作时增加 -U 参数

一般情况下上面方法即可解决问题. 若问题依然存在,请确认下主机与Maven私服之间网络是否畅通.可以通过在浏览器中打开私服地址确认.

若本机与私服之前网络畅通,那这个问题可能是由于私服与中央仓库(或者其他第三方仓库)之间下载依赖时网络故障导致的.

2.2 解决方法:(针对私服与中央仓库或第三方仓库之间网络传输问题)

  1. 使用管理员登陆私服页面(Sonatype Nexus)

  2. 在仓库的浏览页面找到下载失败的包, 右键菜单 "Update Index", 右键菜单 "Expire Cache" 


  3. 按照PC与私服之间网络问题的解决步骤处理一遍

### Maven Dependency 参数详解及用法 #### 1. 基本结构 Maven依赖项通常在`pom.xml`文件中声明,基本结构如下: ```xml <dependencies> <dependency> <groupId>com.example</groupId> <artifactId>example-artifact</artifactId> <version>1.0.0</version> <scope>compile</scope> <type>jar</type> <optional>true</optional> <exclusions> <exclusion> <groupId>*</groupId> <artifactId>*</artifactId> </exclusion> </exclusions> </dependency> </dependencies> ``` 此配置指定了一个具体的依赖项及其属性[^1]。 #### 2. 关键参数说明 ##### groupId, artifactId 和 version 这三个是最基础也是最重要的字段。它们共同唯一标识了一个特定的库或组件。 - `groupId`: 定义了项目所属组的ID。 - `artifactId`: 表示实际构件的名字。 - `version`: 明确指出使用的具体版本号。 这些信息用于定位远程仓库中的资源位置并下载到本地环境[^3]。 ##### scope (作用范围) 决定了该依赖将在哪个阶段被引入以及如何影响编译过程: - **compile**: 默认值;适用于所有阶段(编译、测试、运行)。 - **provided**: 编译期有效但在部署时不打包入最终产物内。 - **runtime**: 运行时期间才需要用到,在编译期间不需要。 - **test**: 只有执行单元测试时才会加载进来。 - **system**: 类似于 provided ,但是还需要指定 systemPath 属性来指向确切的位置。 ##### type (类型) 默认为 jar 文件形式,默认情况下可以省略。如果要引用其他类型的包,则需显式设定,比如 war 或 pom 等特殊格式。 ##### optional (可选标志) 当设为 true 时表示当前模块并不强制要求这个依赖存在,即下游使用者可以选择忽略它而不必担心构建失败问题。 ##### exclusions (排除列表) 允许开发者从传递性依赖链条里移除某些不必要的子依赖,从而减少潜在冲突的可能性。通过定义 exclusion 节点实现这一点[^2]。 ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值