使用mvn deploy命令上传jar包的实现

2025-03-16 13:50
文章标签 实现 使用 命令 上传 jar deploy mvn

本文主要是介绍使用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包的实现的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/1153779。

相关文章

使用jenv工具管理多个JDK版本的方法步骤

使用jenv工具管理多个JDK版本的方法步骤

《使用jenv工具管理多个JDK版本的方法步骤》jenv是一个开源的Java环境管理工具,旨在帮助开发者在同一台机器上轻松管理和切换多个Java版本,：本文主要介绍使用jenv工具管理多个JD... 目录一、jenv到底是干啥的？二、jenv的核心功能（一）管理多个Java版本（二）支持插件扩展（三）环境隔
阅读更多...
Nexus安装和启动的实现教程

Nexus安装和启动的实现教程

《Nexus安装和启动的实现教程》：本文主要介绍Nexus安装和启动的实现教程,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录一、Nexus下载二、Nexus安装和启动三、关闭Nexus总结一、Nexus下载官方下载链接：DownloadWindows系统根
阅读更多...
SQL中JOIN操作的条件使用总结与实践

SQL中JOIN操作的条件使用总结与实践

《SQL中JOIN操作的条件使用总结与实践》在SQL查询中,JOIN操作是多表关联的核心工具,本文将从原理,场景和最佳实践三个方面总结JOIN条件的使用规则,希望可以帮助开发者精准控制查询逻辑... 目录一、ON与WHERE的本质区别二、场景化条件使用规则三、最佳实践建议1.优先使用ON条件2.WHERE用
阅读更多...
SpringBoot集成LiteFlow实现轻量级工作流引擎的详细过程

SpringBoot集成LiteFlow实现轻量级工作流引擎的详细过程

《SpringBoot集成LiteFlow实现轻量级工作流引擎的详细过程》LiteFlow是一款专注于逻辑驱动流程编排的轻量级框架,它以组件化方式快速构建和执行业务流程,有效解耦复杂业务逻辑,下面给大... 目录一、基础概念1.1 组件（Component）1.2 规则（Rule）1.3 上下文（Conte
阅读更多...
Java中Map.Entry()含义及方法使用代码

Java中Map.Entry()含义及方法使用代码

《Java中Map.Entry()含义及方法使用代码》：本文主要介绍Java中Map.Entry()含义及方法使用的相关资料,Map.Entry是Java中Map的静态内部接口,用于表示键值对,其... 目录前言 Map.Entry作用核心方法常见使用场景1. 遍历 Map 的所有键值对2. 直接修改 Ma
阅读更多...
MySQL 衍生表(Derived Tables)的使用

MySQL 衍生表(Derived Tables)的使用

《MySQL衍生表(DerivedTables)的使用》本文主要介绍了MySQL衍生表(DerivedTables)的使用,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学... 目录一、衍生表简介1.1 衍生表基本用法1.2 自定义列名1.3 衍生表的局限在SQL的查询语句select
阅读更多...
MySQL 横向衍生表(Lateral Derived Tables)的实现

MySQL 横向衍生表(Lateral Derived Tables)的实现

《MySQL横向衍生表(LateralDerivedTables)的实现》横向衍生表适用于在需要通过子查询获取中间结果集的场景,相对于普通衍生表,横向衍生表可以引用在其之前出现过的表名,本文就来... 目录一、横向衍生表用法示例1.1 用法示例1.2 使用建议前面我们介绍过mysql中的衍生表（From子句
阅读更多...
Mybatis的分页实现方式

Mybatis的分页实现方式

《Mybatis的分页实现方式》MyBatis的分页实现方式主要有以下几种,每种方式适用于不同的场景,且在性能、灵活性和代码侵入性上有所差异,对Mybatis的分页实现方式感兴趣的朋友一起看看吧... 目录​1. 原生 SQL 分页（物理分页）​​2. RowBounds 分页（逻辑分页）​​3. Page
阅读更多...
Mybatis Plus Join使用方法示例详解

Mybatis Plus Join使用方法示例详解

《MybatisPlusJoin使用方法示例详解》：本文主要介绍MybatisPlusJoin使用方法示例详解,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,... 目录1、pom文件2、yaml配置文件3、分页插件4、示例代码：5、测试代码6、和PageHelper结合6
阅读更多...
Python基于微信OCR引擎实现高效图片文字识别

Python基于微信OCR引擎实现高效图片文字识别

《Python基于微信OCR引擎实现高效图片文字识别》这篇文章主要为大家详细介绍了一款基于微信OCR引擎的图片文字识别桌面应用开发全过程,可以实现从图片拖拽识别到文字提取,感兴趣的小伙伴可以跟随小编一... 目录一、项目概述1.1 开发背景1.2 技术选型1.3 核心优势二、功能详解2.1 核心功能模块2.
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2