Maven部署构件到Nexus时出现的Failed to transfer file错误

我们在项目pom.xml文件中对maven服务器的设置信息如下：

1.  <distributionManagement>
2.        <repository>
3.            <id>nexus-releases</id>
4.            <name>Local Nexus Repository</name>
5.            <url>http://192.168.1.99:8081/content/repositories/releases</url>
6.        </repository>
7.        <snapshotRepository>
8.            <id>nexus-snapshots</id>
9.            <name>Local Nexus Repository</name>
10.            <url>http://192.168.1.99:8081/content/repositories/snapshots</url>
11.        </snapshotRepository>
12.    </distributionManagement>

这里我要说的是在使用的过程中遇到的几个都是“Failed to transfer file”错误，错误信息如下格式：

Error deploying artifact: Failed to transfer file:… Return code is:4xx

也就是说前面错误的信息都是一样的，只是后面返回的HTTP状态数字不同。

1. Return code is: 405
这个问题害我查了两个多小时才发现错误的根源，简单的错误就是在Maven执行到上传文件到服务器的时候出现一个HTTP 405错误。开始的时候总以为是Maven本身的问题，所以在这个上面浪费了不少时间。后来仔细查了405错误的含义是“用来访问本页面的 HTTP 方法不被允许”，最后终于发现是因为前面repository的地址写错了，或者是端口写错，或者是地址中的某个单词拼错了，反正原因就是repository的地址写错了。

2. Return code is: 401或者Return code is: 403
其实403错误就是“禁止访问”的含义，所以问题的根源肯定在授权上面。Maven在默认情况下会使用deployment帐号(默认密码deploy)登录的系统，但是关键的Nexus中Releases仓库默认的Deployment Policy是“Disable Redeploy”，所以无法部署的问题在这个地方，方法是将其修改为“Allow Redeploy”就可以了。

到这里还没有结束，因为如果直接按照上面的设置的话会有一个安全问题，那就是这样所有的开发人员都可以将构件部署到Nexus的releases仓库中了，时间长了会导致这个仓库中非常乱，这也应该是nexus为什么默认情况下将Release仓库的发布权限关闭的原因了。解决这个问题的整体思路就是在部署构件的时候需要使用用户名和密码登录，操作如下：
(1) 首先将Releases仓库默认的Deployment Policy修改为“Allow Redeploy”；
(2) 然后在右边的Security下面的Users中，修改deployment帐号的密码，方法是在帐号上右键，然后选择“Set Password”(PS：这个操作我找了好久，后来无意中右键才找到，呵呵~~)；

(3) 这个时候如果直接执行 mvn deploy 命令的话就又会出现401错误，还有一步就是将密码设置到Maven settings.xml中。打开settings.xml文件(${user.home}/.m/settings.xml或%{m2_home}/conf/settings.xml)，找到<servers>，然后修改信息如下：

1.  <server>
2.        <id>nexus-releases</id>
3.        <username>deployment</username>
4.        <password>deploydv89</password>
5.      </server>
6.  
7.      <server>
8.        <id>nexus-snapshots</id>
9.        <username>deployment</username>
10.        <password>deploydv89</password>
11.     </server>

这里需要特别说明一句的是里面的id必须和你在项目pom.xml文件中distributionManagement下面设置的仓库id一致！当然了，这个里面你也可以设置admin帐号，或者参照deployment的权限手动添加新的帐号等等都是可以的。

3. Return code is: 400
400错误的含义是“错误的请求”，在这里的原因是往往是没有部署到nexus的仓库中。nexus的repository分三种类型：Hosted、Proxy和Virtual，另外还有一个repository group(仓库组)用于对多个仓库进行组合。部署的时候只能部署到Hosted类型的仓库中，如果是其他类型就会出现这个400错误。

还有一种情况也会出现400错误，就是默认情况下部署构件到Releases仓库中有时也会出现400错误，这个原因就像上面提到的那样，Nexus中Releases仓库默认的Deployment Policy是“Disable Redeploy”，所以无论你在settings.xml文件中将server的username设置为deployment还是使用admin都是无法部署的，就会出现这个400错误。这个问题也困扰了我好长时间，而且我还看到网上有人说admin没有部署构件的权限，这个是不对的。修改的方法可以参考上面第2条的做法。