私有倉庫中推送包時提示409錯誤

1. 請檢查云效私有倉庫是否允許覆蓋，嘗試將包版本改為一個新版本或者將 Maven 包版本置為 SNAPSHOT 包再上傳，Snapshot 沒有同版本不允許上傳的限制。

2. 如果是確認倉庫中沒有這個版本的包并且提示409，需要檢查一下是不是在 pom.xml 等文件中有額外配置的插件，導致它會被推送兩次，具體內容參見 Maven release plugin fails : source artifacts getting deployed twice。

通過流水線向私有倉庫中推送 Maven 包時（執行 deploy ）提示認證錯誤

如果日志中顯示推送的倉庫地址的ID（也就是圖片中框出來的）跟云效制品倉庫中的 ID 不一致，請檢查用戶 pom 文件中的配置是否存在問題。

本地向私有倉庫中推送 Maven 包時（執行 Deploy ）提示認證錯誤

1. 如果日志中顯示推送的倉庫地址的ID（也就是圖片中框出來的）跟云效制品倉庫中的 ID 不一致，請檢查用戶 pom 文件中的配置是否存在問題。

   

2. 本地使用的 Settings 文件要確保配置正確，在代碼根目錄下運行mvn clean deploy -s settings.xml -U -DskipTests

   1. 注意： -s 參數為擁有權限往私有倉庫 push 包的賬號（參考倉庫成員權限）登錄云效私有倉庫下載的settings.xml 的文件路徑。

   2. 為了確保本地 settings.xml 配置正確，請在本地運行 mvn help:effective-settings ，通過日志查看私庫地址是否已經配置進去。

云效流水線 Java 構建失敗，下載不到依賴包

請檢查流水線全局設置 - 構建設置是否存在問題，確保其指定了正確的私有倉庫，或者上傳了正確的settings文件。

本地構建失敗，下載不到依賴包

本地構建失敗的排查思路

1. 訪問云效制品倉庫 Packages，在制品搜索中搜索依賴包，如果不存在，請上傳到私有倉庫中；如果已經存在，請操作下一步。

2. 查看制品倉庫的倉庫指南頁面，確保本地正確配置了倉庫的訪問（如 Maven 的 settings.xml，Npm 的 Registry 和認證設置）

3. 對于 Maven 倉庫，按照倉庫指南準備一份 settings.xml ，在本機新建一個空的目錄，比如 /tmp/repo,然后在代碼根目錄下運行mvn clean install -s settings.xml -U -DskipTests -Dmaven.repo.local=/tmp/repo，查看構建是否成功。注意：-s 參數后為擁有權限拉取私服包的賬號（參考倉庫成員權限）登錄云效私服下載的 settings.xml 的文件路徑。

4. 對于 Maven 倉庫，為了確保本地 settings.xml 配置正確，請在本地運行 mvn help:effective-settings ，通過日志查看私庫地址是否已經配置進去。

用戶自有私有倉庫遷移到或者同步到新版云效的 Maven 私有倉庫

1. 可以在云效私有倉庫中直接配置代理，這樣從云效私有倉庫下載時，如果云效私有倉庫不存在這個包，會去代理倉庫中拉取并同時存儲到云效，詳見：倉庫設置。

2. 如果是要將自己的私有倉庫全部遷移到云效私有倉庫的話，可以使用下載遷移工具 migrate-local-repo-tool.jar 遷移，如果數據太多的話建議分批遷移，詳見：將已有私庫同步至云效。

制品庫下載包速度很慢

查看制品倉庫的代理設置，檢查其中是否涉及跨境的代理倉庫，對于跨境的速度無法保證。

上傳 maven 倉庫報錯：Could not PUT 'https://packages.aliyun.com/maven/repository/xxxx/xxx.jar'. Received status code 400 from server

請檢查制品倉庫是否支持 Release 和 Snapshot 包，注意：Release 庫只能上傳 Release 包、Snapshot 庫只能上傳 Snapshot 包（即版本以 -SNAPSHOT 結尾的包）。

能否將 A 制品庫的數據遷移到 B 制品庫

1. 暫不支持云效制品倉庫之間的遷移，且為了防止可能出現的循環代理問題，目前也暫不支持代理到云效制品倉庫

2. 對于 maven 制品庫，建議把多個源配置到同一個 settings.xml 里面