本文主要是介绍使用mvn deploy命令上传jar包的实现,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
《使用mvndeploy命令上传jar包的实现》本文介绍了使用mvndeploy:deploy-file命令将本地仓库中的JAR包重新发布到Maven私服,文中通过示例代码介绍的非常详细,对大家的学...
一、背景
在日常Java开发中,Maven私服作为团队协作的核心枢纽,承载着版本依赖分发的重任。然而,当某天发现私服中关键JAR包离奇丢失,而本地仓库仍保留着历史构建文件时,如何快速从本地“复活”缺失的依赖?此时,如何快速将本地仓库中的 jar 包重新发布到私服,成为恢复构建环境的关键。本文将详细介绍如何使用 mvn deploy:deploy-file 命令将本地仓库中的 jar 包发布到私服,并分享在此过程中可能遇到的问题及其解决方案,帮助开发者高效解决类似问题。
二、环境
- Nexus Repository Manager OSS 2.15.1-02
- Apache Maven 3.3.9
- Java version: 17.0.9
- win 10
三、配置nexus上传账号
配置 maven 的 settings.XML 文件,在配置文件中添加2个 server节点,并输入 nexus 的用户名和密码。配置中的id要记住命令中需要使用。
<servers> <server> <id>snapshots</id> <username>admin</username> <password>******</password> </server> <server> <id>release</id> <username>admin</username> <password>******</password> </server> </servers>
四、执行deploy命令上传包
以下命令都是基于cmd,方便查看都用了^将命令分为多行。mvn配置不光在maven安装目录下,还有用户的环境配置。
执行命令前避免其它配置干扰,最好把只保留maven目录下的配置。
- 检查环境可以执行 mvn -X命令,看看加载了那些配置。
- 查看有效配置可以执行 mvn help:effective-settings命令
1. 首先需要把本地仓中要上传到jar、pom复制到其它目录中
cd /d D:\temp\maven\
2. 确定待上传包版本
上传的包版本决定,上传路径和使用repoitoryId值。-Durl参数的实际路径需要在私服中自己找~~~,配置错了就各种错!!!
-DrepositoryId参数值需要和settings.xml的server id节点值一至。
SNAPSHOT包参数
- 包名有snapshot关键字,如:mydtemo-0.0.1-SNAPSHOT.jar需要使用以下参数值
- -Durl=https://nexus.demo.com/nexus/content/repositories/snapshots/
- -DrepositoryId=snapshots
release包参数
- 没有有snapshot关键字的为release包,如:mydtemo-0.0.1.jar需要使用以下参数值
- -Durl=https://nexus.demo.com/nexus/content/repositories/releases/
- -DrepositoryId=releases
3. 执行上传命令
待上传的jar包如果有对应pom文件,pom中的maven坐标没有引用变量时,比较省事指定一个-DpomFile就可以了
# 指定pomFile参数时,不需要填写groupId、artifactId、version三个参数 mvn -e deploy:deploy-file ^ -Dfile=./mydtemo-2025.3.7.jar ^ -DpomFile=./mydtemo-2025.3.7.pom ^ -Dpackaging=jphpar ^ -Durl=https://nexus.demo.com/nexus/content/repositories/releases/ ^ -DrepositoryId=releases
如果没有pom文件就需要手动指定maven坐标,仔细点儿否则容易出错,导致拉取依赖找不到包。
# 无pom文件时,需要填写groupId、artifactId、version三个参数 mvn -e deploy:deploy-file ^ -Dfile=./mydtemo-2025.3.7.jar ^ -DgroupId=com.mydemo.test ^ -DartifactId=mydtemo ^ -Dversion=2025.3.7 ^ -Dpackaging=jar ^ -Durl=https://nexus.demo.com/nexus/content/repositories/releases/ ^ -DrepositoryId=releases
如果是snapshot包,参数稍微有点儿区别。这里还有个场景就是指定-Dclassifier参数,在 Maven 中,classifier 属性用于区分同一 artifact 的不同版本或变种。通常,一个 artifact 由 groupId、artifactId 和 version 三个基本元素确定。然而,在某些情况下,我们可能需要为同一个 artifact 创建多个不同的版本或变种,比如源代码包、文档包或特定平台的二进制包等。
# 指定classifier参数,向snapshot仓发布jar包 mvn -e deploy:deploy-file ^ -Dfile=./mydtemo-spring-1.0.11-SNAPSHOT-dto.jar ^ -DgroupId=com.mydemo.test ^ -DartifactId=mydtemo ^ -Dversion=spring-1.0.11-SNAPSHOT ^ -Dclassifier=dto ^ -Dpackaging=jar ^ -Durl=https://nexus.demo.com/nexus/content/repositories/snapshots/ ^ -DrepositoryId=nexus-snapshots
如果只是上传pom文件,file参数也需要指定。
cd /d D:\temp\maven\ # 只上传pom文件 mvn -e deploy:deploy-file ^ -Dfile=./mydemo-1.2.0.pom ^ -DpomFile=./mydemo-1.2.0.pom ^ -Durl=https://nexus.demo.cChina编程om/nexus/content/repositories/releases/ ^ -DrepositoryId=releases
五、执行dependency命令测试下载依赖
上面如果顺利的话,已经上传到私服了,下面测试下拉取依赖,当然在idea中也可测试。
命令格式
mvn -e dependency:get ^ -Dartifact=mydtemo:com.mydemo.test:jar:2025.3.7
也可以指定配置文件,来取其它仓的依赖。
# 指定配置文件拉取 mvn dependency:get ^ -Dartifact=mydemo:mydemo:pom:1.2.0 ^ -s D:\maven\apache-maven-3.3.9\conf\settings.xml
如果懒得去本地仓中翻找,可以指定下载地址,测试时打开一个目录就可以了。
# 指定下载目录(先下载到本仓之后在copy到-Ddest指定的目录中) mvn -e -X dependency:get ^ -Dartifact=com.mydemo.test:mydtemo:2025.3.7 ^ -DrepoUrl=https://nexus.demo.com/nexus/content/repositories/releases/ ^ -Ddest=E:\downloads\mvn-test
六、命令解释
命令解释:mvn deploy:deploy-编程file
mvn deploy:deploy-file
是 Maven 提供的一个命令,用于将本地文件(如 jar 包或 pom 文件)直接上传到 Maven 私服(如 Nexus 或 Artifactory)。以下是该命令的详细参数说明:
1. 命令名
mvn deploy:deploy-file
这是 Maven 的命令名称,用于将本地文件上传到远程仓库。
2. -Dfile=
作用:指定要上传的 jar 文件路径。
说明:
- 路径可以是绝对路径或相对路径。
- 建议将要上传的 jar 包放在一个简单的目录下,避免路径过长或复杂。
示例:
-Dfile=target/my-artifact-1.0.0.jar
3. -DpomFile=
作用:指定与 jar 包对应的 pom 文件路径。
说明:
- 如果上传的是 jar 包,必须同时指定
-Dfile
和-DpomFile
。 - 如果只上传 pom 文件,只需指定
-DpomFile
。
示例:
-DpomFile=pom.xml
4. -Dpackaging=
作用:指定要上传的文件类型。
说明:
- 常见的类型包括
jar
和pom
。 - 上传 jar 包时,类型为
jar
;上传 pom 文件时,类型为pom
。
示例:
-Dpackaging=jar
5. -Durl=
作用:指定要上传的 Nexus 仓库地址。
说明:
- Snapshots 版本的 jar 包必须上传到 Snapshots 仓库。
- Releases 版本的 jar 包必须上传到 Releases 仓库。
- 如果类型不匹配(例如将 Releases 包上传到 Snapshots 仓库),会报
status code 400
异常。
示例:
-Durl=http://nexus.example.com/repository/maven-releases/
6. -DrepositoryId=
作用:指定使用的仓库 ID。
说明:
- 该 ID 必须与
settings.xml
文件中的<server>
配置的id
一致。 - 如果匹配不到 ID,会报
status code 405
异常。
示例:
-DrepositoryId=my-nexus-repo
7. 自动解析 pom 文件
说明:
- 上传成功后,Maven 会解析 pom 文件,自动识别 jar 包的存储路径。
- 确保 pom 文件中的
groupId
、artifactId
和version
信息正确,否则可能导致上传失败或路径错误。
完整示例命令
以下是一个完整的示例命令,将本地 jar 包和 pom 文件上传到 Nexus 私服:
mvn deploy:deploy-file \ -Dfile=target/my-artifact-1.0.0.jar \ -DpomFile=pom.xml \ -Dpackaging=jar \ -Dujsrl=http://nexus.example.com/repository/maven-releases/ \ -DrepositoryId=my-nexus-repo
七、常见问题及解决方案
1. status code 400 异常
原因:上传的 jar 包类型与仓库类型不匹配(例如将 Releases 包上传到 Snapshots 仓库)。
解决:检查 -Durl
参数,确保上传到正确的仓库。
详情:
[ERROR] Failed to execute goal org.apache.maven.plugins:maven-deploy-plugin:2.7:deploy-file (default-cli) on project standalone-pom: Failed to deploy artifacts: Could not transfer artifact com.mydemo.test:**mydemo:jar:2025.3.7 from/to releases (https://com.mydemo.test/nexus/content/repositories/public/): Failed to transfer file: https://com.mydemo.test/nexus/content/repositories/public/com/com/mydemo/**mydemo/2025.3.7/**mydemo-2025.3.7.jar. Return code is: 400, ReasonPhrase: Bad Request.
2. status code 405 异常
- 原因:
-DrepositoryId
与settings.xml
中的<server>
配置不匹配。 - 解决:检查
settings.xml
文件,确保id
一致。
详情:
[ERROR] Failed to execute goal org.apache.maven.plugins:maven-deploy-plugin:2.7:deploy-file (default-cli) on project standalone-pom: Failed to deploy artifacts: Could not transfer artifact com.mydemo.test:**mydemo:jar:2025.3.7 from/to releasesx (https://com.mydemo.test/nexus/content/repositories/releases/): Failed to transfer file: https://com.mydemo.test/..../....jar. Return code is: 401, ReasonPhrase: Unauthorized.
3. Could not find artifact 异常
- 原因:pom 文件中的
groupId
、artifactId
或version
信息错误。 - 解决:检查 pom 文件,确保坐标信息正确。
4. Return code is: 401权限问题
原因:上传仓库需要认证,但未配置正确的用户名和密码。
解决:在 settings.xml
中配置 <server>
的认证信息。
错误详情:
[ERROR] Failed to execute goal org.apache.maven.plugins:maven-deploy-plugin:2.7:deploy-file (default-cli) on project standalone-pom: Failed to deploy artifacts: Could not transfer artifact com.mydemo.test:**mydemo:jar:2025.3.7 from/to releases (https://com.mydemo.test/nexus/content/repositories/releases/): Failed to transfer file: https://com.mydemo.test/..../....jar. Return code is: 401, ReasonPhrase: Unauthorized.
5. 不能从本地仓直接上传
需要把本地仓的jar包复制到其它目录。
[ERROR] Failed to execute goal org.apache.maven.plugins:maven-deploy-plugin:2.7:deploy-file (default-cli) on project standalone-pom: Cannot deploy artifact from the local repository: D:\java\maven\maven_repo\com\mydemo\test\**mydemo\2025.3.7\**mydemo-2025.3.7.jar
总结
mvn deploy:deploy-file
是将本地 jar 包或 pom 文件上传到 Maven 私服的重要命令。通过正确配置 -Dfile
、-DpomFile
、-Durl
和 -DrepositoryId
等参数,可以高效完成上传任务。同时,注意仓库类型、权限和 pom 文件信息的正确性,避免常见错误。有时候maven版本高或者第也会导致上传失败。
到此这篇关于使用mvn deploy命令上传jar包的文章就介绍到这了,更多相关mvn deploy上传jar包内容请搜索编程China编程(www.chinasem.cn)以前的文章或继续浏览下面的相关文章希望大家以后多多支持China编程(www.chinasem.cn)!
这篇关于使用mvn deploy命令上传jar包的实现的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!