如何在Jenkins（Docker代理）中获取合并请求的Git变更文件

我之前也碰到过类似的情况——用Docker代理跑Jenkins时，git diff经常因为分支拉取不完整或环境变量配置问题出故障，给你几个可行的方案试试：

一、修复git diff命令，直接用CLI获取 #

你说git diff没输出，大概率是Jenkins的Git插件默认只拉取当前分支，或是没指定正确的对比分支。试试下面的操作：

• 先拉取目标分支的最新代码：

  git fetch origin ${CI_MERGE_REQUEST_TARGET_BRANCH_NAME}:${CI_MERGE_REQUEST_TARGET_BRANCH_NAME}
  

  这里的环境变量是GitLab自动注入的，如果Jenkins是通过GitLab触发的任务，这些变量可以直接用；如果是手动配置的任务，你可以手动替换成具体分支名，比如origin/main。
• 再执行对比命令获取变更文件名：

  git diff --name-only origin/${CI_MERGE_REQUEST_TARGET_BRANCH_NAME}...origin/${CI_MERGE_REQUEST_SOURCE_BRANCH_NAME}
  

  这里用三个点...是为了精准对比MR里实际要合并的内容，避免包含分支间的历史差异；如果用两个点..会对比所有提交差异，可能拿到多余文件。

要是还是不行，试试切换分支后再对比：

git checkout ${CI_MERGE_REQUEST_TARGET_BRANCH_NAME}
git pull origin ${CI_MERGE_REQUEST_TARGET_BRANCH_NAME}
git checkout ${CI_MERGE_REQUEST_SOURCE_BRANCH_NAME}
git diff --name-only ${CI_MERGE_REQUEST_TARGET_BRANCH_NAME}

二、利用可用的git status命令提取文件名 #

既然git status能正常工作，那我们可以用它的简洁输出格式来提取文件：

• 先执行git status --porcelain，它会输出类似这样的结构化内容：

  M  src/main/java/com/example/Test.java
  A  src/main/resources/config.yaml
  D  src/test/java/com/example/OldTest.java
  

• 再用awk或sed提取文件名部分：

  git status --porcelain | awk '{print $2}' > changed_files.txt
  

  这样就能把所有变更文件名存入changed_files.txt，后续操作直接读取这个文件就行。如果你的变更文件包含空格，换用更严谨的写法：

  git status --porcelain | sed -E 's/^[AMDR ]{2} //' > changed_files.txt
  

三、通过GitLab Webhook + API获取变更文件 #

如果想绕开CLI的问题，用GitLab API是更可靠的方式：

1. 先在GitLab项目里配置Merge Request事件的Webhook，触发条件选Merge request events，确保Jenkins能正常接收这个Webhook请求。
2. 在Jenkins任务中，从Webhook的payload里提取MR的ID（object_attributes.iid）和项目ID（project.id）。
3. 用GitLab个人访问令牌（需要拥有api权限）调用API获取变更文件：

   curl --header "PRIVATE-TOKEN: ${GITLAB_ACCESS_TOKEN}" \
        "https://你的GitLab地址/api/v4/projects/${PROJECT_ID}/merge_requests/${MR_IID}/changes"
   

   这个API返回的JSON里，changes数组包含了所有变更文件的信息，每个元素的new_path就是文件名。你可以用jq工具提取：

   curl --header "PRIVATE-TOKEN: ${GITLAB_ACCESS_TOKEN}" \
        "https://你的GitLab地址/api/v4/projects/${PROJECT_ID}/merge_requests/${MR_IID}/changes" | \
        jq -r '.changes[].new_path' > changed_files.txt
   

   记得在Jenkins的Docker代理里安装jq工具，或者用Jenkins的GitLab插件来处理JSON，不用自己写curl命令。

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