Maven2部署構件到Nexus時出現的Failed to transfer file錯誤
具體怎樣使用deploy命令部署構件到nexus伺服器上可以參考經典的《Maven Definitive Guide》(Maven操作指南)，書中的16.7節裡面講解的非常詳細。假設我們在專案pom.xml檔案中對maven伺服器的設定資訊如下：
- <distributionManagement>
- <repository>
- <id>nexus-releases</id>
- <name>Local Nexus Repository</name>
-
<url>http://192.168.1.99:8081/content/repositories/releases</url>
- </repository>
- <snapshotRepository>
- <id>nexus-snapshots</id>
- <name>Local Nexus Repository</name>
- <url>http://192.168.1.99:8081/content/repositories/snapshots</url>
- </snapshotRepository>
- </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>，然後修改資訊如下：
- <server>
- <id>nexus-releases</id>
- <username>deployment</username>
- <password>deploydv89</password>
- </server>
- <server>
- <id>nexus-snapshots</id>
- <username>deployment</username>
- <password>deploydv89</password>
- </server>
這裡需要特別說明一句的是裡面的id必須和你在專案pom.xml檔案中distributionManagement下面設定的倉庫id一致！當然了，這個裡面你也可以設定admin帳號，或者參照deployment的許可權手動新增新的帳號等等都是可以的。
當然，問題到這裡已經得到了比較完美的解放，但是如果有人還要較真的話會想到帳號的密碼直接放到配置檔案裡面不是很安全。其實只要這裡不建議放admin帳號，而deployment是無法登入的。如果非要更安全一些的話，也可以使用Maven 2.1.0之後所提供的密碼加密功能，操作的步驟如下：
(1) 使用“mvn --encrypt-master-password xxx”或“mvn --emp xxx”建立一個主金鑰，後面的xxx就是你所要設定的金鑰的內容，這個金鑰主要用於後面加密密碼來用的；命令執行之後會產生一個類似{jSMOWnoPFgsHVpMvz5VrIt5kRbzGpI8u+9EF1iFQyJQ=}形式的字串。
(2) 在${user.home}/.m/目錄下建立一個名為settings-security.xml檔案，我們將剛剛產生的主金鑰放到這個檔案中，檔案的內容如下：
- <?xmlversion="1.0"encoding="UTF-8"?>
- <settingsSecurity>
- <master>{jSMOWnoPFgsHVpMvz5VrIt5kRbzGpI8u+9EF1iFQyJQ=}</master>
- </settingsSecurity>
注意，這個settings-security.xml檔案一定要放在${user.home}/.m/目錄下面，而不能放在${m2_home}/conf目錄下！
(3) 使用“mvn --encrypt-password xxx”或“mvn --ep xxx”命令對帳號的密碼進行加密，後面的xxx就是帳號的密碼，加密之後依然會產生一個“{xxx}”形式的字串，將這個字串替換上面settings.xml檔案中的server下面的password節點內容即可。
還有一種更安全的方式，就是將主金鑰放到U盤裡面，具體的操作可以看下面的參考資料。
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條的做法。