Maven无法找到deploy插件且插件下载失败，如何上传非Maven构建制品？

为什么Maven无法下载插件？ #

这类错误的核心原因是Maven无法从配置的仓库（默认是中央仓库）获取所需插件及依赖，常见诱因包括：

• 网络/访问限制：公司防火墙拦截、代理未配置，导致无法连接中央仓库；或者仓库访问超时、不稳定。
• 本地仓库损坏：本地.m2/repository目录中缓存的插件文件（如pom、jar）损坏或不完整，Maven重复尝试下载仍失败。
• Maven配置缺失：settings.xml未配置加速镜像，或代理信息错误，导致仓库访问失败。

解决插件下载问题的步骤 #

1. 验证网络连通性
   直接访问Maven中央仓库的基础地址，确认网络能正常访问。若为公司网络，联系IT确认是否需要配置代理。

2. 清理本地损坏缓存
   删除本地.m2/repository/org/apache/maven/plugins目录，重新执行命令，让Maven重新下载完整的插件文件。

3. 配置镜像加速（推荐）
   在settings.xml的<mirrors>节点中添加国内镜像（如阿里云），替换默认中央仓库以提升下载速度：

   <mirrors>
     <mirror>
       <id>aliyunmaven</id>
       <mirrorOf>central</mirrorOf>
       <url>https://maven.aliyun.com/repository/public</url>
     </mirror>
   </mirrors>
   

4. 配置代理（如需）
   若公司网络需要代理，在settings.xml的<proxies>节点中添加代理信息：

   <proxies>
     <proxy>
       <id>company-proxy</id>
       <active>true</active>
       <protocol>http</protocol>
       <host>proxy.example.com</host>
       <port>8080</port>
       <username>your-proxy-username</username>
       <password>your-proxy-password</password>
       <nonProxyHosts>localhost|127.0.0.1</nonProxyHosts>
     </proxy>
   </proxies>
   

完成制品上传的正确操作 #

解决插件下载问题后，确保以下几点再执行部署命令：

1. 配置仓库认证信息
   在settings.xml的<servers>节点中添加目标仓库的账号密码（需与命令中-DrepositoryId=xxxx的xxxx对应）：

   <servers>
     <server>
       <id>xxxx</id>
       <username>your-repo-username</username>
       <password>your-repo-password</password>
     </server>
   </servers>
   

2. 修正部署命令
   去掉命令开头的@符号（Windows环境无需该前缀），执行完整命令：

   mvn deploy:deploy-file -Dfile=C:\Users\XX\myArtifact.zip -Dname=myArtifact -DartifactId=ServerBinaries -DgroupId=org.myArtifact -Dversion=1.0.0 -Dpackaging=zip -DrepositoryId=xxxx -Durl=http://xxxx/repository/thirdparty -DgeneratePom=true
   

3. 指定插件完整坐标（备选方案）
   如果仍出现prefix 'deploy' not found错误，可直接使用插件完整坐标执行命令，绕过前缀匹配：

   mvn org.apache.maven.plugins:maven-deploy-plugin:3.1.0:deploy-file -Dfile=C:\Users\XX\myArtifact.zip -Dname=myArtifact -DartifactId=ServerBinaries -DgroupId=org.myArtifact -Dversion=1.0.0 -Dpackaging=zip -DrepositoryId=xxxx -Durl=http://xxxx/repository/thirdparty -DgeneratePom=true
   

内容的提问来源于stack exchange，提问作者Tacy Nathan