Jenkins上Maven构建仅拉取远程仓库、无法读取本地已装依赖问题求助

• Maven镜像配置拦截了本地仓库查询
  如果Maven settings.xml中配置了mirrorOf=*的全局镜像，会强制所有依赖查询都走配置的镜像站点，跳过本地仓库校验，报错直接指向AsposeJavaAPI仓库，大概率是镜像或仓库优先级配置导致。
• 依赖坐标不匹配
  mvn install:install-file命令中填写的groupId、artifactId、version参数，和pom.xml中声明的该依赖坐标不一致，哪怕是大小写、符号的细微差别都会导致Maven判定为两个不同的依赖，无法匹配到本地已安装的jar包。
• Jenkins Maven任务的仓库配置异常
  Jenkins的Maven集成插件如果开启了每个构建使用独立的本地仓库选项，会为每个任务生成隔离的仓库路径，不会读取默认的/var/lib/jenkins/.m2/repository路径下的资源。
• 本地仓库文件权限不足
  虽然jar包已经写入了jenkins用户的.m2目录，但如果安装时使用的是其他用户执行install命令，会导致jar包的文件权限不允许jenkins进程读取，Maven查询不到可读的本地文件就会转向远程仓库拉取。

1. 调整Maven settings.xml配置
   找到Jenkins调用Maven时使用的配置文件，确认节点下没有mirrorOf=*的全局配置，如果必须配置全局镜像，可以添加排除规则：

<mirror>
  <id>custom-mirror</id>
  <mirrorOf>*,!your-group-id</mirrorOf>
  <url>镜像仓库地址</url>
</mirror>

将上述配置中的your-group-id替换为你自定义jar的groupId，该groupId下的依赖就不会走镜像查询，同时确认settings.xml中的<localRepository>节点配置值确实为/var/lib/jenkins/.m2/repository。
2. 核对依赖坐标
对比install命令的参数和pom.xml中的依赖声明，确保groupId、artifactId、version三个参数完全一致。
3. 检查Jenkins任务配置
进入对应任务的配置页，找到构建模块的Maven配置，确认没有勾选「使用私有Maven仓库」选项，如果勾选了可以取消勾选，或者在该任务的前置步骤中单独执行一次install命令安装对应jar包。
4. 校验文件权限
执行以下命令修改本地仓库中对应jar包的权限，确保jenkins用户可读：
chown -R jenkins:jenkins /var/lib/jenkins/.m2/repository/

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