已本地安装Maven依赖仍触发镜像下载的问题排查

可能的原因及对应解决方案 #

1. Maven镜像配置强制所有请求走远程仓库 #

从报错信息看，Maven尝试从internal-repository（指向中央仓库）下载依赖，说明你的settings.xml中可能配置了mirrorOf=*的镜像规则，这会让Maven将所有仓库请求（包括本地仓库的查找）都转发到远程镜像，忽略本地已安装的依赖。

解决方法：
修改settings.xml中的镜像配置，将mirrorOf的值改为central而非*，仅对中央仓库的请求走镜像，本地仓库的依赖会被优先使用：

<mirrors>
  <mirror>
    <id>internal-repository</id>
    <mirrorOf>central</mirrorOf> <!-- 替换原来的* -->
    <url>https://repo.maven.apache.org/maven2/</url>
  </mirror>
</mirrors>

2. Jenkins环境下Maven使用的本地仓库路径与安装路径不一致 #

你确认依赖安装在/home/jenkins/.m2/repository，但Jenkins可能配置了自定义的Maven本地仓库（比如全局工具配置中指定了其他路径，或项目使用独立settings.xml覆盖了localRepository）。

解决方法：

• 检查Jenkins中Maven的配置：进入Jenkins后台 → 全局工具配置 → 找到Maven安装项，确认本地仓库路径。
• 若路径不一致，重新执行安装命令时通过-Dmaven.repo.local指定Jenkins实际使用的本地仓库：

mvn install:install-file '-Dfile=code-base-2.1.2.jar' '-DgroupId=com.rd' '-DartifactId=code-base' '-Dversion=2.1.2' '-Dpackaging=jar' '-Dmaven.repo.local=<Jenkins实际本地仓库路径>'

3. 本地仓库中依赖的元数据文件损坏或缺失 #

Maven依赖的元数据文件（如maven-metadata-local.xml、_remote.repositories）可能损坏，导致Maven认为该依赖未正确安装。

解决方法：

• 删除本地仓库中该依赖的目录：

rm -rf /home/jenkins/.m2/repository/com/rd/code-base/2.1.2

• 重新执行install:install-file命令，确保生成完整的元数据文件。
• 执行mvn clean install -U，-U参数强制Maven更新依赖状态，重新检查本地仓库。

4. 安装时自动生成的临时POM无效 #

安装时Maven自动生成的临时POM可能存在格式问题或缺失必要信息，导致Maven无法识别该依赖。

解决方法：
如果从Nexus能获取到对应POM文件，安装时手动指定：

mvn install:install-file '-Dfile=code-base-2.1.2.jar' '-DpomFile=code-base-2.1.2.pom' '-DgroupId=com.rd' '-DartifactId=code-base' '-Dversion=2.1.2' '-Dpackaging=jar'

若没有现成POM，可手动创建简单POM后再执行安装：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.rd</groupId>
    <artifactId>code-base</artifactId>
    <version>2.1.2</version>
</project>

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