如何在Maven中配置仓库镜像？代码举例讲解

发表于2023年8月28日2023年7月15日作者 IT之美

在Maven中配置仓库镜像的主要步骤是:

在settings.xml中的元素下添加子元素:

<mirrors>
    <mirror>
        <id>alimaven</id>
        <name>aliyun maven</name>
        <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
        <mirrorOf>central</mirrorOf>        
    </mirror>
</mirrors>

元素指定要镜像的仓库ID,通常为central。
元素指定镜像仓库的地址。
配置完成后,当我们的pom.xml中依赖一个仓库时,Maven会自动将请求转发到镜像上。
也可以只在某个pom.xml中配置来覆盖全局镜像:

<project>
  ...
  <repositories>
    <repository>
      <id>central</id>
      <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
      <releases>
        <enabled>true</enabled>
      </releases>
      <snapshots>
        <enabled>true</enabled>
      </snapshots>
    </repository>
  </repositories>
</project>

Maven仓库镜像的主要作用是:

加速依赖解析,通过镜像仓库提高下载速度。
降低对中央仓库的依赖,避免因其宕机或网络波动对构建产生影响。
针对中央仓库做 bwlist 过滤。
实现自定义的缓存机制。

来看一个简单示例:
在settings.xml中添加镜像配置:

<mirrors>
    <mirror>
        <id>alimaven</id>
        <name>aliyun maven</name>
        <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
        <mirrorOf>central</mirrorOf>        
    </mirror>
</mirrors>

则Maven在解析依赖时,会自动从http://maven.aliyun.com/nexus/content/groups/public/下载,而非中央仓库。

也可以在pom.xml中单独配置:

<repositories>
    <repository>
      <id>central</id>
      <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
      <releases>
        <enabled>true</enabled>
      </releases>
      <snapshots>
        <enabled>true</enabled>
      </snapshots>
    </repository> 
</repositories>

则该pom下的依赖会从阿里云仓库解析。

所以,通过配置Maven镜像可以有效解决依赖下载慢、网络波动等问题。