Maven仓库与镜像配置解析过程揭秘

在Maven中，仓库和镜像改如何进行配置呢？今天，我们就来彻底理清Maven仓库与镜像配置解析的过程！

在Maven下载依赖时，当配置了多个仓库和镜像，解析顺序遵循特定的规则。我们需要理解Maven配置的基本结构：核心配置文件包括用户或全局的settings.xml以及项目级别的pom.xml。仓库配置可以出现在这两个文件中，而镜像配置仅存在于settings.xml文件中，其核心作用是替代一个或多个仓库的实际访问地址。

比如，可以设置一个镜像，当Maven尝试访问某个仓库时，会被重定向到镜像地址。镜像可以覆盖特定的仓库或者所有仓库。例如，在settings.xml中配置一个镜像，将所有对中央仓库的请求转到国内的镜像站点，这样下载速度会更快。

Maven处理依赖查找的过程：首先明确需要下载的依赖项，随后严格按照仓库在配置文件中的声明顺序依次尝试访问每个仓库。在访问每个特定仓库之前，Maven会检查settings.xml中的镜像配置，寻找与该仓库id匹配的镜像。如果找到匹配的镜像，Maven会使用settings.xml中匹配的镜像URL替换原仓库URL，如果没有镜像匹配，直接访问仓库的URL，直到找到依赖为止。因此，仓库的声明顺序始终决定访问尝试的先后次序，而镜像只负责替换实际请求的URL，不会改变仓库的尝试顺序。

关键点在于，仓库的配置顺序决定了访问的顺序，而镜像的配置决定了实际访问的url。也就是说，镜像的存在不会改变仓库的访问顺序，只是改变了访问的地址。

关于镜像的匹配规则，mirrorOf可以指定要匹配的仓库id，可以使用通配符，比如：

*：匹配所有仓库
external:*：匹配除本地和基于文件的仓库之外的所有仓库
repo1,repo2：匹配repo1和repo2
!repo1：排除repo1

因此，镜像的配置可以非常灵活，覆盖特定的仓库或一组仓库。

如果多个镜像匹配同一个仓库，此时选择第一个匹配的镜像。比如镜像1匹配仓库A，镜像2也匹配仓库A，那么Maven会使用第一个匹配的镜像。也就是说，在settings.xml中镜像的声明顺序会影响镜像的选择。

如果第一个镜像M配置为mirrorOf=*，那么无论全部声明的仓库的顺序如何，仓库地址是什么，所有仓库的请求都被镜像拦截，都会去访问镜像M的地址。

示例：

xml 复制代码

<?xml version="1.0" encoding="UTF-8"?>

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
    
    <profiles>
        <profile>
            <id>dev</id>
            <repositories>
                <repository>
                  <id>spring</id>
                  <url>https://maven.aliyun.com/repository/spring</url>
                  <snapshots>
                    <enabled>true</enabled>
                  </snapshots>
                  <releases>
                    <enabled>true</enabled>
                  </releases>
                </repository>
                <repository>
                    <id>central</id>
                    <url>https://repo.maven.apache.org/maven2</url>
                    <snapshots>
                        <enabled>true</enabled>
                    </snapshots>
                    <releases>
                        <enabled>true</enabled>
                    </releases>
                </repository>
            </repositories>
        </profile>
    </profiles>

    <activeProfiles>
        <activeProfile>dev</activeProfile>
    </activeProfiles>
    
    <mirrors>
        <mirror>
            <id>aliyun</id>
            <name>aliyun</name>
            <url>https://maven.aliyun.com/repository/public</url>
            <mirrorOf>central</mirrorOf>
        </mirror>
    </mirrors>
</settings>

上例中，settings.xml配置了spring仓库和central仓库，也为central仓库配置了镜像aliyun，那么Maven会先尝试访问spring仓库，如果找不到依赖，再尝试访问central仓库，由于central仓库配置了阿里云仓库镜像，因此访问central仓库的地址为阿里云仓库地址。

中央仓库（central）是默认的仓库，即使没有显式配置中央仓库，在配置的全部仓库中如果没有找到依赖，最终也会使用中央仓库。如果配置了镜像，那么中央仓库的访问会被镜像替代。

因此，镜像配置会影响实际访问的地址，但仓库的顺序仍然决定了访问的先后顺序。

一般常见的误区是认为镜像的配置顺序会影响仓库的访问顺序，但实际上，镜像只是替换url，不改变仓库的顺序。除非镜像覆盖所有仓库，从而将所有请求集中到一个镜像，此时原仓库的顺序不再有效。

因此，最终的解析顺序是：先应用镜像替换，然后按原仓库顺序访问替换后的地址。

验证配置效果：

shell 复制代码

mvn dependency:get -Dartifact=com.github:failed:1.0.0 -Dtransitive=false -X

观察日志中的 Downloading from 字段，确认实际访问顺序。