Jenkins中Maven项目依赖其他Maven项目运行异常求助

云原生阿岚

2026-5-28

解决Jenkins中Maven项目依赖内部构件的问题

我来帮你拆解下这个问题的本质和完整解决步骤——你遇到的核心问题是Maven默认只会去中央仓库找依赖，而你的Projects-2是内部项目，根本没上传到中央仓库，而且之前的失败结果被本地仓库缓存了，所以才会反复报那个错。下面是一步步的解决方案：

核心原因拆解

无法解析com.ctl.it.qa:Project-1:jar:1.0.0-SNAPSHOT的依赖：在https://repo.maven.apache.org/maven2中未找到com.ctl.it.qa:Projects-2:jar:1.1.1

这个错误直白说就是：Maven在中央仓库搜不到Projects-2的1.1.1版本，而且它已经把“找不到”这个结果存在本地仓库里了，默认不会再重试，除非你强制更新或者缓存过期。而你手里的Projects-2项目，要么只在本地构建了没部署到共享仓库，要么Jenkins的Project-1根本没配置去查你的内部仓库。

完整解决方案步骤

1. 先把Projects-2的构件部署到共享仓库

首先得让Projects-2的构建产物能被其他项目访问到，只在Jenkins agent本地install是不行的——因为其他项目可能跑在不同的agent上，或者本地仓库不共享。

修改Projects-2的pom.xml，添加部署仓库配置（假设你有公司私有仓库比如Nexus/Artifactory，或者用Jenkins自带的Maven仓库）：

<distributionManagement>
  <repository>
    <id>internal-releases</id>
    <url>http://你的私有仓库地址/releases</url>
  </repository>
  <snapshotRepository>
    <id>internal-snapshots</id>
    <url>http://你的私有仓库地址/snapshots</url>
  </snapshotRepository>
</distributionManagement>

在Jenkins里配置仓库权限：进入Manage Jenkins -> Global Tool Configuration -> Maven，找到你的Maven安装，点击Configure，在Maven Settings里添加仓库的账号密码（对应上面的<id>）：

<servers>
  <server>
    <id>internal-releases</id>
    <username>仓库用户名</username>
    <password>仓库密码</password>
  </server>
  <server>
    <id>internal-snapshots</id>
    <username>仓库用户名</username>
    <password>仓库密码</password>
  </server>
</servers>

修改Projects-2的Jenkins构建步骤：把Maven目标从clean install改成clean deploy，这样构建完成后会自动把构件上传到你配置的私有仓库里。去Jenkins的构建日志里确认，能看到Uploaded to internal-releases或者类似的日志就说明部署成功了。

2. 让Project-1能找到私有仓库里的依赖

现在Projects-2的构件在私有仓库了，得告诉Project-1去那里找，而不是只盯着中央仓库。

修改Project-1的pom.xml（或者全局Maven settings），添加私有仓库的配置：

<repositories>
  <repository>
    <id>internal-releases</id>
    <url>http://你的私有仓库地址/releases</url>
    <releases>
      <enabled>true</enabled>
    </releases>
    <snapshots>
      <enabled>false</enabled>
    </snapshots>
  </repository>
  <repository>
    <id>internal-snapshots</id>
    <url>http://你的私有仓库地址/snapshots</url>
    <releases>
      <enabled>false</enabled>
    </releases>
    <snapshots>
      <enabled>true</enabled>
    </snapshots>
  </repository>
</repositories>

这样Maven会先查你的私有仓库，找不到再去中央仓库。

3. 确保Jenkins构建的依赖顺序（关键！）

不管你用Pipeline还是多阶段项目，必须保证Projects-2先完成部署，再启动Project-1的构建。

用Pipeline的例子：

pipeline {
  agent any
  stages {
    stage('Build & Deploy Projects-2') {
      steps {
        // 等待Projects-2构建完成并成功，再往下走
        build job: 'Projects-2', wait: true, propagate: true
      }
    }
    stage('Build Project-1') {
      steps {
        // 加-U参数强制更新依赖，清除之前的失败缓存
        sh 'mvn clean install -U'
      }
    }
  }
}

用自由风格项目的话：

在Project-1的构建触发器里，勾选“Build after other projects are built”，然后选择Projects-2，并且勾选“Trigger only if build is stable”，确保Projects-2构建成功才触发Project-1。

4. 清除缓存（临时应急）

如果之前的失败缓存还在本地仓库里，即使配置对了，Maven可能还是会用缓存结果。这时候可以：

手动删除Project-2在本地仓库的目录（比如~/.m2/repository/com/ctl/it/qa/Projects-2）
或者在Maven命令里加-U参数，强制Maven更新依赖缓存，就像上面Pipeline里写的那样。

容易遗漏的检查点

确认Projects-2的版本号是1.1.1，和Project-1依赖里的版本完全一致（包括大小写、有没有SNAPSHOT后缀，Maven对这些是严格敏感的）。
确认Projects-2的Jenkins构建确实执行了deploy，日志里有上传构件的记录。
如果你们没有私有仓库，也可以让两个项目共用同一个Jenkins agent的本地仓库，但这种方式不推荐，因为agent更换或者清理后依赖就没了。

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

Jenkins中Maven项目依赖其他Maven项目运行异常求助

核心原因拆解 #

完整解决方案步骤 #

1. 先把Projects-2的构件部署到共享仓库 #

2. 让Project-1能找到私有仓库里的依赖 #

3. 确保Jenkins构建的依赖顺序（关键！） #