闭网环境下仅使用私有Nexus Maven仓库配置问题求助

闭网环境配Maven私有仓库这个坑我踩过好多次，你这个问题大概率是把镜像和仓库的配置项搞混了，给你一套稳的配置方案和排查思路：

一、核心配置修正（针对settings.xml） #

Maven的仓库优先级和镜像转发规则很容易搞晕，直接按下面的配置来，确保所有请求都走私有Nexus：

1. 配置全局镜像，强制所有请求转发到私有Nexus #

在settings.xml的<mirrors>节点下添加这段配置，重点是mirrorOf="*"，它会把所有仓库请求都导向你的私有Nexus：

<mirror>
  <id>nexus-private</id>
  <!-- 匹配所有仓库请求，不要用true/false这类无效值 -->
  <mirrorOf>*</mirrorOf>
  <!-- 替换成你的Nexus仓库地址，比如maven-public是默认的聚合仓库 -->
  <url>http://你的Nexus服务器IP:端口/repository/maven-public/</url>
</mirror>

2. 配置默认激活的私有仓库Profile #

在settings.xml的<profiles>节点下添加这个Profile，确保Maven只会识别你的私有仓库，同时禁用默认的中央仓库：

<profile>
  <id>private-repo-only</id>
  <!-- 设为默认激活，不需要手动指定profile -->
  <activation>
    <activeByDefault>true</activeByDefault>
  </activation>
  <!-- 配置依赖仓库 -->
  <repositories>
    <repository>
      <id>nexus-private</id>
      <url>http://你的Nexus服务器IP:端口/repository/maven-public/</url>
      <releases>
        <enabled>true</enabled>
      </releases>
      <snapshots>
        <enabled>true</enabled>
      </snapshots>
    </repository>
  </repositories>
  <!-- 配置插件仓库（很容易被忽略！） -->
  <pluginRepositories>
    <pluginRepository>
      <id>nexus-private</id>
      <url>http://你的Nexus服务器IP:端口/repository/maven-public/</url>
      <releases>
        <enabled>true</enabled>
      </releases>
      <snapshots>
        <enabled>true</enabled>
      </snapshots>
    </pluginRepository>
  </pluginRepositories>
</profile>

3. 额外的保险配置 #

• 删掉项目pom.xml里所有<repositories>和<pluginRepositories>的外部仓库配置，统一由settings.xml管理
• 检查Nexus的maven-public仓库是否包含了你手动上传的所有包仓库（比如第三方包仓库、本地上传的release仓库）

二、为什么你之前的配置会出问题？ #

你提到的“设为false仍访问官方，设为true不访私有”，应该是把两个不同的配置项搞混了：

• 如果是把<releases><enabled>false</enabled></releases>设为false，这只是禁用了私有仓库的下载权限，但Maven会自动去默认的中央仓库（来自Maven自带的super pom）找包
• 如果错误地把<mirrorOf>设成了true，这是无效取值，Maven会直接忽略这个镜像规则，同时如果你的私有仓库没被正确配置到Profile里，自然就不会访问私有仓库了

三、验证配置是否生效 #

执行下面的命令，查看Maven的实际生效配置和下载日志：

# 查看生效的settings配置，确认mirrors和repositories只有私有Nexus
mvn help:effective-settings

# 执行构建并查看详细日志，检查所有Downloading请求都指向私有Nexus
mvn clean install -X

如果日志里还出现repo.maven.apache.org，就看日志里的触发来源——大概率是某个插件依赖没走私有仓库，这时候要检查pluginRepositories的配置是否正确。

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