单Git仓库多Java Web项目的Jenkins配置及构建失败问题

先给大家看看咱们的项目代码结构，方便理解场景：

项目代码结构 #

$ git clone git@git-server:/data/git/project.git
$ tree -L 1 project
.
├── pushServer
├── README
├── redis_cloud_task
├── Time
├── access
├── business
├── business_client
├── common
├── parent
└── web

$ tree -L 1 project/pushServer/
pushServer/
├── cert
├── config
├── lib
├── pom.xml
├── resource
├── src
└── WebRoot

遇到的问题 #

现在咱们有多个Java Web项目都存在同一个Git仓库里，比如要构建common项目，Jenkins里只能指定整个仓库的地址git@git-server:/data/git/project.git，但构建时直接报错「无法找到要构建的版本」，具体日志如下：

构建错误日志 #

Building in workspace /data/srv/tomcat/jenkins/workspace/common
> git rev-parse --is-inside-work-tree # timeout=10
Fetching changes from the remote Git repository
> git config remote.origin.url git@git-server:/data/git/project.git # timeout=10
Fetching upstream changes from git@git-server:/data/git/project.git
> git --version # timeout=10
> git fetch --tags --progress git@git-server:/data/git/project.git +refs/heads/*:refs/remotes/origin/*
> git rev-parse origin/${branch_tag}^{commit} # timeout=10
> git rev-parse ${branch_tag}^{commit} # timeout=10
ERROR: Couldn't find any revision to build. Verify the repository and branch configuration for this job.
Finished: FAILURE

问题排查与解决步骤 #

这个错误主要有两个核心原因：要么是分支/标签的配置出了问题，要么是Jenkins没正确聚焦到咱们要构建的子项目上。下面一步步来解决：

第一步：先把分支配置搞对 #

看日志里的${branch_tag}，这明显是个未正确定义的变量，或者构建时没传入合法值。咱们得这么改：

• 如果是固定分支构建，直接填具体的分支名，比如main或者develop，别用这种没定义的变量；
• 如果要用参数化构建（让构建时可以选分支），得先在Jenkins任务的「参数化构建过程」里添加「字符串参数」，变量名设为branch_tag，默认值填常用分支比如main，确保构建时能传入有效的分支名；
• 顺便确认下这个分支在远程仓库真的存在，本地执行git ls-remote git@git-server:/data/git/project.git就能看到所有远程分支和标签。

第二步：让Jenkins只关注目标子项目 #

因为咱们只需要构建仓库里的common，而不是整个仓库，有两种实用的方式：

方式一：指定克隆到子目录，再指向子项目的POM

1. 进入Jenkins任务的「源码管理」→「Git」，点击「高级」按钮；
2. 在「Relative target directory」里填个目录名，比如git-repo，这样Jenkins会把整个仓库克隆到工作区的git-repo文件夹里；
3. 然后在Maven构建步骤里，把「根POM」的路径设为git-repo/common/pom.xml，这样Maven就会专门构建common项目了。

方式二：用稀疏检出只拉取需要的子目录（适合大仓库）

如果仓库很大，拉整个仓库太费时间空间，可以用稀疏检出：

1. 同样在Git的「高级」选项里，勾选「稀疏检出」；
2. 点击「添加」，输入common/（注意末尾的斜杠，确保只拉取这个目录）；
3. 这样Jenkins只会克隆仓库的目录结构，只拉取common下的内容，效率更高。

第三步：修正Maven配置 #

结合上面的设置，调整Maven的配置：

• 确保根POM的路径完全正确，比如用稀疏检出的话就填common/pom.xml，用子目录克隆就填git-repo/common/pom.xml；
• 目标和参数根据项目需求设置，比如clean package -DskipTests，避免跑测试拖慢构建。

第四步：验证效果 #

保存配置后手动触发一次构建，看日志：

• 如果看到Checking out Revision xxx (refs/heads/main)这类信息，说明代码拉取成功了；
• 后续Maven构建完成后，能生成对应的jar/war包，就说明配置没问题啦。

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