如何关闭Maven 3.9.X的Remote Repository Filtering功能？

Maven 3.9.x引入的远程仓库过滤（RRF）功能会校验本地缓存构件的来源仓库是否在当前构建上下文里可用。如果你的personal仓库未在配置中声明，或者RRF规则限制了它，Maven就会尝试从Central仓库重新获取那些明明已经在本地的构件。

下面是几种可行的解决方式：

1. 全局禁用RRF（适用于所有项目） #

编辑~/.m2/settings.xml，添加一个默认激活的配置文件，直接关闭RRF功能：

<profiles>
  <profile>
    <id>disable-rrf</id>
    <activation>
      <activeByDefault>true</activeByDefault>
    </activation>
    <properties>
      <maven.resolver.remoteRepositoryFiltering>disabled</maven.resolver.remoteRepositoryFiltering>
    </properties>
  </profile>
</profiles>

这样Maven会回到3.9.x之前的仓库查找逻辑，不再校验构件来源仓库的可用性。

2. 针对个人仓库配置RRF规则（推荐，更精准） #

如果你只想让个人仓库的构件跳过RRF校验，不需要全局关闭功能，可以这么做：

第一步：在settings.xml中声明个人仓库 #

确保personal仓库被正确配置到构建上下文里：

<repositories>
  <repository>
    <id>personal</id>
    <url>你的个人仓库实际地址</url>
    <releases>
      <enabled>true</enabled>
    </releases>
    <snapshots>
      <enabled>false</enabled>
    </snapshots>
  </repository>
</repositories>

第二步：添加RRF允许规则 #

在settings.xml的<profiles>里添加规则，允许com.personal.space下的所有构件从personal仓库获取：

<profile>
  <id>allow-personal-repo</id>
  <activeByDefault>true</activeByDefault>
  <properties>
    <maven.resolver.remoteRepositoryFiltering.rules>
      +com.personal.space:*:personal
    </maven.resolver.remoteRepositoryFiltering.rules>
  </properties>
</profile>

这个规则的格式是+[groupId前缀]:[artifactId]:[仓库ID]，*表示匹配所有artifactId。配置后，Maven就不会再去Central验证这些构件了。

3. 命令行临时禁用RRF #

如果只是临时处理单次构建的问题，可以直接在Maven命令后加参数：

mvn clean install -Dmaven.resolver.remoteRepositoryFiltering=disabled

注意事项 #

• 配置里的仓库ID必须和本地缓存中标记的完全一致（你的本地缓存里是personal，所以ID不能写错）。
• 不要随意给Central仓库添加过滤规则，否则可能导致插件、插件依赖等基础构件无法获取，引发构建失败。

内容的提问来源于stack exchange，提问作者McFlurriez