Maven仓库中 _remote.repositories文件介绍

结论: 通过删除仓库中的_remote.repositories文件,解决由于更换仓库带来的jar包不兼容/重新下载问题

1. 结构构成:

举个栗子

#Thu Jan 24 11:42:29 CST 2019
logback-parent-1.1.1.pom>nexus-aliyun=
logback-parent-1.1.1.pom>nexus-xx=
logback-parent-1.1.1.pom>mirror-all=
这里的nexus-aliyun表示setting.xml中配置的私服id
其中
这个文件存储的是每次从私服或者中央仓库下载的jar包的信息。
该logback-parent只有pom管理,所以没有jar

第3行:表示该pom第一次从nexus-aliyun(阿里云镜像)来的

第4行:表示更换远程仓库nexus-xx(xx私服)且该私服存在该pom,那么就将该私服地址写入到_remote.repositories.

第5行:表示镜像服务器mirror-all存在该pom

只有存在该资源的镜像或私服才会将私服或镜像的id写入到_remote.repositories中

参考资料:https://www.cnblogs.com/mySummer/p/9453777.html

假设我们更换了私服地址为nexus-abc,并且该私服不存在该资源,那么就会生成logback-parent-1.1.1.pom.lastUpdated文件;
也就是说,_remote.repositories文件,标示该资源的来源,如果你有这个_remote.repositories,那就会在访问本地的同时,必须确保远程上有才行(这里的远程是setting文件中配置的镜像或远程仓库,用id来进行关联,详情见标题2._remote…),否则就会报错;
参考资料:https://blog.csdn.net/zzb5682119/article/details/89217780
错误信息大体如下:

Could not resolve dependencies for project com-hallo-mybatis:generator:jar:1.0-SNAPSHOT: 
The following artifacts could not be resolved: com.tencent.tsf:spring-cloud-tsf-dependencies:pom:1.1.1-
RELEASE, com.tencent.tsf:spring-cloud-tsf-sleuth:jar:1.1.1-RELEASE, com.tencent.tsf:spring-cloud-tsf-
auth:jar:1.1.1-RELEASE: Failure to find com.tencent.tsf:spring-cloud-tsf-dependencies:pom:1.1.1-RELEASE in 
<span style="color:#ab4642">http://***:8081/repository/public/ was cached in the local repository, resolution 
will not be reattempted until the update interval of public has elapsed or updates are forced</span>

2._remote.*和setting文件的py关系

<mirrors>
    <mirror>
      <!-- * 表示我这个镜像服务器要代替所有的仓库 -->
      <mirrorOf>*</mirrorOf>
      <name>mirror-all</name>
      <url>http://mirrors.cloud.tencent.com/nexus/repository/maven-public/</url>
      <id>custom</id>
</mirror>
<repositories>
     <repository>
         <id>central</id>
         <url>http://repo1.maven.org/maven2</url>
         <releases>
             <enabled>true</enabled>
         </releases>
         <snapshots>
             <enabled>true</enabled>
         </snapshots>
     </repository>
 </repositories>
_remote.repositories中>符号后的字符为setting文件中配置的<mirror>标签下的id,也就是镜像服务器的id(自己定义),
也可以是<repository>标签下的id,表示远程仓库的id(自己定义);具体看本地仓库的构件是从哪里下载的;

3.maven setting配置文件 tips
3.1 setting不配置镜像或仓库时,会自动请求apache的maven仓库
3.2 标签解读
<localRepository>本地仓库的路径

<!-- 默认值为${user.home}/.m2/repository。 -->
windows用户请注意,默认是在C盘

<pluginGroups>第三方插件的groupId(不常用)

例如:以下为springBoot的地址,但是为什么在idea中却不用指定该groupId也可以使用,
		是因为boot的maven中指定了<goalPrefix>spring-boot</goalPrefix>命令前缀
<pluginGroups>  
       <pluginGroup>org.springframework.boot</pluginGroup>  
</pluginGroups>

<proxies>给maven配置代理(不常用)

<!--用来配置不同的代理,多代理profiles 可以应对笔记本或移动设备的工作环境:通过简单的设置profile id就可以很容易的更换整个代理配置。 -->
 <proxies>
  <!--代理元素包含配置代理时需要的信息-->
  <proxy>
   <!--代理的唯一定义符,用来区分不同的代理元素。-->
   <id>myproxy</id>
   <!--该代理是否是激活的那个。true则激活代理。当我们声明了一组代理,而某个时候只需要激活一个代理的时候,该元素就可以派上用处。 -->
   <active>true</active>
   <!--代理的协议。 协议://主机名:端口,分隔成离散的元素以方便配置。-->
   <protocol>http</protocol>
   <!--代理的主机名。协议://主机名:端口,分隔成离散的元素以方便配置。  -->
   <host>proxy.somewhere.com</host>
   <!--代理的端口。协议://主机名:端口,分隔成离散的元素以方便配置。 -->
   <port>8080</port>
   <!--代理的用户名,用户名和密码表示代理服务器认证的登录名和密码。 -->
   <username>proxyuser</username>
   <!--代理的密码,用户名和密码表示代理服务器认证的登录名和密码。 -->
   <password>somepassword</password>
   <!--不该被代理的主机名列表。该列表的分隔符由代理服务器指定;例子中使用了竖线分隔符,使用逗号分隔也很常见。-->
   <nonProxyHosts>*.google.com|ibiblio.org</nonProxyHosts>
  </proxy>
 </proxies>

<servers>远程仓库的配置文件(deploy构件时常用,需要配置私服的账号及密码)

<!--配置服务端的一些设置。一些设置如安全证书不应该和pom.xml一起分发。这种类型的信息应该存在于构建服务器上的settings.xml文件中。-->
<servers>
 <!--服务器元素包含配置服务器时需要的信息 -->
 <server>
  <!--这是server的id(注意不是用户登陆的id),该id与distributionManagement中repository元素的id相匹配。-->
  <id>server001</id>
  <!--鉴权用户名。鉴权用户名和鉴权密码表示服务器认证所需要的登录名和密码。 -->
  <username>my_login</username>
  <!--鉴权密码 。鉴权用户名和鉴权密码表示服务器认证所需要的登录名和密码。密码加密功能已被添加到2.1.0 +。详情请访问密码加密页面-->
  <password>my_password</password>
  <!--鉴权时使用的私钥位置。和前两个元素类似,私钥位置和私钥密码指定了一个私钥的路径(默认是${user.home}/.ssh/id_dsa)以及如果需要的话,一个密语。将来passphrase和password元素可能会被提取到外部,但目前它们必须在settings.xml文件以纯文本的形式声明。 -->
  <privateKey>${usr.home}/.ssh/id_dsa</privateKey>
  <!--鉴权时使用的私钥密码。-->
  <passphrase>some_passphrase</passphrase>
  <!--文件被创建时的权限。如果在部署的时候会创建一个仓库文件或者目录,这时候就可以使用权限(permission)。这两个元素合法的值是一个三位数字,其对应了unix文件系统的权限,如664,或者775。 -->
  <filePermissions>664</filePermissions>
  <!--目录被创建时的权限。 -->
  <directoryPermissions>775</directoryPermissions>
 </server>
</servers>

<mirrors>镜像服务器地址(常用,一般配置aliyun镜像)

可以配置多个镜像
<mirrors>
        <mirror>
        <!--该镜像的唯一标识符。id用来区分不同的mirror元素。且与_remote.repositories有关系 -->
              <id>alimaven</id>
              <!--被镜像的仓库的id。例如,要设置为<repository>中id为def的仓库的景象,就需要将该元素设置成def。表示为仓库def的镜像,注意给该仓库设置镜像后,所有的构建请求将不再请求def仓库,所以,建议不要给私服设置镜像。-->
              <!-- 还有'*'表示镜像所有的仓库,'*,!def'表示镜像除def仓库外的其他所有仓库(适合def为私服时设置) -->
              <mirrorOf>def</mirrorOf>
              <name>aliyun maven</name>
              <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
        </mirror>
        ...
</mirrors>

<repositories>仓库配置(常用,id与标签mirrorOf和_remote.repositories有关,repositories标签常配置在下)

<!--远程仓库列表,它是Maven用来填充构建系统本地仓库所使用的一组远程项目。 -->
   <repositories>
    <!--包含需要连接到远程仓库的信息 -->
    <repository>
     <!--远程仓库唯一标识-->
     <id>codehausSnapshots</id>
     <!--远程仓库名称 -->
     <name>Codehaus Snapshots</name>
     <!--如何处理远程仓库里发布版本的下载-->
     <releases>
      <!--true或者false表示该仓库是否为下载某种类型构件(发布版,快照版)开启。  -->
      <enabled>false</enabled>
      <!--该元素指定更新发生的频率。Maven会比较本地POM和远程POM的时间戳。这里的选项是:always(一直),daily(默认,每日),interval:X(这里X是以分钟为单位的时间间隔),或者never(从不)。 -->
      <updatePolicy>always</updatePolicy>
      <!--当Maven验证构件校验文件失败时该怎么做-ignore(忽略),fail(失败),或者warn(警告)。-->
      <checksumPolicy>warn</checksumPolicy>
     </releases>
     <!--如何处理远程仓库里快照版本的下载。有了releases和snapshots这两组配置,POM就可以在每个单独的仓库中,为每种类型的构件采取不同的策略。例如,可能有人会决定只为开发目的开启对快照版本下载的支持。参见repositories/repository/releases元素-->
     <snapshots>
      <enabled/><updatePolicy/><checksumPolicy/>
     </snapshots>
     <!--远程仓库URL,按protocol://hostname/path形式 -->
     <url>http://snapshots.maven.codehaus.org/maven2</url>
     <!--用于定位和排序构件的仓库布局类型-可以是default(默认)或者legacy(遗留)。Maven 2为其仓库提供了一个默认的布局;然而,Maven 1.x有一种不同的布局。我们可以使用该元素指定布局是default(默认)还是legacy(遗留)。 -->
     <layout>default</layout>
    </repository>
   </repositories>
   <!--发现插件的远程仓库列表。仓库是两种主要构件的家。第一种构件被用作其它构件的依赖。这是中央仓库中存储的大部分构件类型。另外一种构件类型是插件。Maven插件是一种特殊类型的构件。由于这个原因,插件仓库独立于其它仓库。pluginRepositories元素的结构和repositories元素的结构类似。每个pluginRepository元素指定一个Maven可以用来寻找新插件的远程地址。-->
   <pluginRepositories>
    <!--包含需要连接到远程插件仓库的信息.参见profiles/profile/repositories/repository元素的说明-->
          <pluginRepository>           
     <releases>      
      <enabled/><updatePolicy/><checksumPolicy/>
     </releases>
     <snapshots>
      <enabled/><updatePolicy/><checksumPolicy/>
     </snapshots>
     <id/><name/><url/><layout/>
     \</pluginRepository>
</pluginRepositories>

<profiles>配置不同的profiles,使setting.xml配置和pom.xml进行联动
(在idea mavenProjects边栏中的profiles会出现这里设置的profiles的id,如下面的test,当被选中时它的值会覆盖任何其它定义在POM中或者profile.xml中的带有相同id的profile,通常配置在标签下)

 <!--根据环境参数来调整构建配置的列表。settings.xml中的profile元素是pom.xml中profile元素的裁剪版本。它包含了id,activation, repositories, pluginRepositories和 properties元素。这里的profile元素只包含这五个子元素是因为这里只关心构建系统这个整体(这正是settings.xml文件的角色定位),而非单独的项目对象模型设置。如果一个settings中的profile被激活,它的值会覆盖任何其它定义在POM中或者profile.xml中的带有相同id的profile。 -->
<profiles>
 <!--根据环境参数来调整的构件的配置-->
 <profile>
  <!--该配置的唯一标识符。 -->
  <id>test</id>

<activeProfiles>使配置的profiles手动生效(注意,如果这里不启用某一个profile的话,profile下的repositories将不会生效,默认仓库还是apache的默认仓库;另:这里设置的activeProfile会与pom.xml设置的profile产生联动,相同的id会被激活)
在这里插入图片描述

<activeProfiles>
    <activeProfile>nexus</activeProfile>
    <activeProfile>qcloud-repo</activeProfile>
    <activeProfile>prd</activeProfile>  <!-- prd的profile在项目的pom.xml中定义 -->
</activeProfiles>
<!--手动激活profiles的列表,按照profile被应用的顺序定义activeProfile。 该元素包含了一组activeProfile元素,每个activeProfile都含有一个profile id。任何在activeProfile中定义的profile id,不论环境设置如何,其对应的
     profile都会被激活。如果没有匹配的profile,则什么都不会发生。例如,env-test是一个activeProfile,则在pom.xml(或者profile.xml)中对应id的profile会被激活。如果运行过程中找不到这样一个profile,Maven则会像往常一样运行。 -->
<activeProfiles>
 <activeProfile>env-test</activeProfile>
 <activeProfile>test</activeProfile>
</activeProfiles>
</settings>

pom.xml配置构件发布
使用<distributionManagement>配置发布的私服地址及id
例:

*pom.xml*
<distributionManagement>
		<!-- 正式版发布仓库 -->
		<repository>
		<!-- 这里的id要求配置用户名及密码,在setting.xml中进行配置,通过id进行关联 -->
			<id>nexus-server@public</id>
			<url>http://ip:8081/repository/maven-releases</url>
		</repository>
		<!-- 快照版发布仓库 -->
		<snapshotRepository>
			<id>nexus-server@public-snapshots</id>
			<url>http://ip:8081/repository/maven-snapshots</url>
		</snapshotRepository>
</distributionManagement>
*setting.xml*
<servers>
    <server>
        <id>nexus-server@public</id>
        <username>admin</username>
        <password>admin</password>
    </server>
     <server>
       <id>nexus-server@public-snapshots</id>
       <username>admin</username>
       <password>admin</password>
</server>

更多关于标签的知识详见Maven系列二setting.xml 配置详解
本文只是对maven使用过程中的一点记录
耳鸣了一天,脑袋瓜子嗡嗡的

Logo

旨在为数千万中国开发者提供一个无缝且高效的云端环境,以支持学习、使用和贡献开源项目。

更多推荐