Maven 下載 JAR 包慢？一鍵配置阿里云/OSChina 國內鏡像，享受飛一般的速度

Maven 下載 JAR 包慢？一鍵配置阿里云/OSChina 國內鏡像，享受飛一般的速度

Maven 默認從中央倉庫 https://repo.maven.apache.org/maven2 下載依賴，國內訪問經常龜速、斷點、超時。通過在 settings.xml 配置 鏡像，將請求導向國內高速節點（阿里云、OSChina 等），下載速度可提升 10-50 倍。

操作步驟（以 Eclipse 為例）

1. 打開 Eclipse → Window → Preferences
2. 搜索 Maven → User Settings
3. 找到 settings.xml 路徑（若無則手動創建於 ${user.home}/.m2/settings.xml）
4. 用編輯器（Notepad++/VS Code）打開修改 <mirrors> 節點

推薦鏡像配置（直接複製替換 <mirrors> 內容）

<mirrors>
    <!-- 阿里云 Maven 鏡像（推薦首選，同步快、穩定、全） -->
    <mirror>
        <id>alimaven</id>
        <name>aliyun maven</name>
        <url>https://maven.aliyun.com/nexus/content/groups/public/</url>
        <mirrorOf>central</mirrorOf>
    </mirror>

    <!-- OSChina 中央倉庫鏡像（備選） -->
    <mirror>
        <id>CN</id>
        <name>OSChina Central</name>
        <url>https://maven.oschina.net/content/groups/public/</url>
        <mirrorOf>central</mirrorOf>
    </mirror>

    <!-- 英國中央倉庫（海外節點備用） -->
    <mirror>
        <id>uk</id>>
        <name>UK Maven Central</name>
        <url>https://uk.maven.org/maven2/</url>
        <mirrorOf>central</mirrorOf>
    </mirror>

    <!-- 官方中央倉庫（最後兜底） -->
    <mirror>
        <id>central-default</id>
        <name>Maven Central Default</name>
        <url>https://repo.maven.apache.org/maven2</url>
        <mirrorOf>central</mirrorOf>
    </mirror>
</mirrors>

關鍵屬性解析

• id：唯一標識
• mirrorOf：central 表示鏡像中央倉庫；* 表示鏡像所有倉庫（含私服，慎用）
• url：鏡像地址，建議使用 HTTPS（阿里云已支持）
• 優先級：XML 中越靠前優先級越高，Maven 會按順序嘗試

驗證生效

# 命令行執行，觀察下載地址是否為鏡像站
mvn dependency:resolve -U
# 或清理本地倉庫重新構建
mvn clean compile -U

進階：企業級私服 Nexus 搭建

團隊協作建議搭建 Nexus/Artifactory 私服，代理所有外部倉庫，內網下載達到 MB/s 級別，同時管理內部發布構件。配置示例：

<mirror>
    <id>nexus</id>
    <name>Internal Nexus</name>
    <url>https://192.168.1.100:8081/nexus/content/groups/public/</url>
    <mirrorOf>*,!internal-snapshots</mirrorOf> <!-- 代理所有外部，除內部快照 -->
</mirror>

總結

修改 settings.xml 添加國內鏡像是解決 Maven 下載慢的零成本、立竿見影方案。推薦 阿里云為首選，OSChina 為備選，順手配上私服，告別「正在下載...」的漫長等待！