⭐⭐⭐ Spring Boot 项目实战	⭐⭐⭐ Spring Cloud 项目实战
《Dubbo 实现原理与源码解析 —— 精品合集》	《Netty 实现原理与源码解析 —— 精品合集》
《Spring 实现原理与源码解析 —— 精品合集》	《MyBatis 实现原理与源码解析 —— 精品合集》
《Spring MVC 实现原理与源码解析 —— 精品合集》	《数据库实体设计合集》
《Spring Boot 实现原理与源码解析 —— 精品合集》	《Java 面试题 + Java 学习指南》

摘要: 原创出处 juejin.cn/post/7218128044666372154 「树哥聊编程」欢迎转载，保留摘要，谢谢！

🙂🙂🙂关注**微信公众号：【芋道源码】**有福利：

RocketMQ / MyCAT / Sharding-JDBC 所有源码分析文章列表

RocketMQ / MyCAT / Sharding-JDBC 中文注释源码 GitHub 地址

您对于源码的疑问每条留言都将得到认真回复。甚至不知道如何读源码也可以请教噢。

新的源码解析文章实时收到通知。每周更新一篇左右。

认真的源码交流微信群。

业务需求开发的时候，我们总是会遇到拉不到依赖包的情况。此时如果不清楚 Maven 拉取依赖包的原理，那么很可能找不到问题所在。今天树哥就带大家了解下 Maven 拉包的原理，让你在遇到问题的时候能快速解决！

三种仓库

在 Maven 中，仓库指的是存放代码构建的一个位置。从分类上来说，Maven 仓库有两种类型，分别是：

本地仓库（Local）
远程仓库（Remote）

本地仓库，是存在于本地的一个仓库，它用来缓存下载的依赖包。这样就不用每次都通过网络去拉取依赖包了，提高了依赖拉取速度，减轻了仓库服务器的压力。

远程仓库，如其名字所述，其实位于远程服务器的一个仓库。例如有些公司自己对外开放了一些 API，需要将这些 API 的依赖开放出去，这时候就可以将 API 的 Jar 包放到公司自己的远程仓库中。公司的客户可以通过连接该仓库下载 Jar 包。例如你们公司开发了自己的基础工具类，并将其打成了一个 Jar 包。此时你可以将该 Jar 包部署到公司自己的远程仓库中，公司其他开发伙伴配置该远程仓库，从而可以拉取到该 Jar 包依赖。

「在网上其他资料中，还会提到 Maven 仓库有另一个类型 —— 中央仓库（Central）。但在我看来，中央仓库其实是一个特殊的远程仓库。」 它的特殊之处在于，它是 Maven 官方提供的，其中包括了大量常用的库，基本上大多数的依赖包都可以在这里找到。另外一个特殊之处在于，中央仓库的地址是内置在 Maven 源码中的，即默认会向中央仓库拉取依赖，这个在后续的依赖搜索顺序中会讲到。

而我们经常说的私服，其实也是一个特殊的远程仓库，其特殊之处在于：它只对公司内部开放，方便存放一些本团队创建的开发库。我们经常说的阿里云 Maven 库，其实就是一个远程仓库，只不过其是对所有人开放罢了。

依赖搜索顺序

弄懂了仓库的类型，我们继续来了解下依赖的搜索顺序。

我们在开发过程中找不到依赖包，有多种原因，例如：

依赖包确实没有放到远程仓库
仓库配置有问题
等等

为了弄清楚到底是什么原因导致依赖找不到，我们需要了解 Maven 是如何找一个依赖的。简单来说，Maven 搜索依赖的算法如下：

首先，在本地仓库搜索，如果找不到则继续下一步。
接着，在中央仓库搜索，如果找不到则继续下一步。
最后，在远程仓库中搜索，如果找不到则抛出错误。如果没有设置远程仓库，那么抛出错误。如果找到了依赖，那么就下载到本地仓库缓存。

简单地说，Maven 搜索遵循简单的顺序 —— 本地仓库 -> 中央仓库 -> 远程仓库。弄明白了这个依赖搜索顺序，可以帮助我们更好地排查问题。但这可能还不够，我们还需要搞清楚 Maven setting.xml 中的一些配置信息，从而可以排查是否是配置出现了问题。例如：有时候我们配置了 mirror 镜像，会把对某个仓库的请求转发到另一个仓库，这时候你要是不懂 mirror 配置，你就找不到问题所在了。

配置信息

关于仓库的一些常见的配置项有：

repositories
mirror
server
等等

下面我们将一个个讲解他们的作用。

repositories 标签

repositories 标签用于定义远程仓库，其配置范例如下所示：

<repositories>
 <repository>
        <!--公司镜像的唯一标识，这个配置要注意，不能与mirrorOf配置的相同，不然会被拦截，重定向到外网的镜像仓库 -->
        <id>nexus</id>
        <!--仓库描述，随意写 -->
        <name>xxxx</name>
        <!-- 公司私有仓库地址，这个很重要不能错-->
        <url>http://xxx:8081/nexus/content/groups/public</url>
        <!-- 是否开启 releases 包的下载及更新策略 -->
        <releases>
            <enabled>true</enabled>
            <updatePolicy>daily</updatePolicy>
        </releases>
        <!-- 是否开启 snapshots 包的下载及更新策略 -->
        <snapshots>
            <enabled>false</enabled>
            <checksumPolicy>warn</checksumPolicy>
        </snapshots>
        <layout>default</layout>
 </repository>
 </repositories>

repositories 标签既可以在 setting.xml 文件配置，也可以在 pom.xml 文件中配置。Maven 在拉取依赖的时候，是按照声明的顺序从上到下去对应的远程仓库拉取依赖的。

mirror 标签

mirror 标签用于定义仓库镜像，其相当于一个拦截器。当 mirror 的 mirrorOf 值与 repository 的 id 相同时，repository 定义的仓库会被拦截，转而使用 mirror 中定义的仓库地址。配置范例如下：

<!--使用xx公司私有仓库替换Maven默认的中央仓库 -->
<mirrors>
    <mirror>
        <!--自己公司的镜像的唯一标识,在mirror标签中，其实没啥用：如xiaoyaziyun -->
        <id>xiaoyaziyun</id>   
        <!--仓库描述，随意写 -->
        <name>xx公司私有仓库地址</name> 
        <!--xx公司私有仓库地址，这个很重要不能错-->
        <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
        <!--`central`为Maven中央仓库的标识，替换Maven源码内默认的是中央仓库地址-->
        <mirrorOf>central</mirrorOf>
    </mirror>
</mirrors>

如上图配置所示，Maven 会用 http://maven.aliyun.com/nexus/content/groups/public/ 这个仓库镜像替换 Maven 中央仓库，其中 central 是 Maven 中央仓库的 ID 标识。我们经常说用阿里云的 Maven 仓库可以提速，其实就是使用这种方法实现的。

server 标签

大部分远程仓库无须认证就可以访问，但我们自己搭建的 Maven 仓库，处于安全方面的考虑，我们会设置访问权限。此时，我们需要在 setting.xml 文件中配置 server标签。配置示例如下代码所示：

<settings>
    <!--配置远程仓库认证信息-->
     <servers>
        <server>
             <id>shuyi-tech-repo</id>
             <username>admin</username>
             <password>admin123</password>
         </server>
     </servers>
</settings>

上面的配置为 repository id 为 shuyi-tech-repo 的远程仓库配置了用户名和密码，其中用户名为 admin，密码为 admin123。这里通过 server.id 与 reposiroty.id 标签将认证信息与仓库绑定在一起，因此在配置的时候需要保持这两个信息一致，否则可能导致访问失败。

其他标签

proxy 标签：服务器不能直接访问外网时需要设置的代理服务，不常用。
profiles 标签：上面提到mirror，配置多个只会一个有效，如果需要多仓库配置，可以在profiles节点下配置多个profile，但是配置需要激活，特别麻烦，也不常用。

配置文件优先级

对于 Maven 来说，我们会看到有多个配置文件：

项目 pom.xml 文件
.m2/settings.xml 文件
Maven 安装目录 /conf/settings.xml 文件

如果一个配置同时存在于多个位置，那么到底以哪个为准呢？简单地说，这几个配置文件的优先级是怎样的呢？如果没搞懂这个问题，那么我们排查问题的时候可能会一团糟。

其实三者的优先级是 pom.xml >/用户/.m2/settings.xml>/maven安装目录/conf/settings.xml。如果要设置全局 Maven 仓库配置，需要在 Maven 安装目录 /conf 下找到 settings.xml 来修改。

芋道源码 —— 纯源码解析博客

一文带你弄懂 Maven 拉包原理