GitLab合并请求场景下如何列出所有待合并文件或全部合并提交

原有逻辑仅通过最后一次提交的哈希执行diff-tree，天然只能获取单提交的变更文件，多提交的MR场景必然存在校验覆盖不全的问题。可通过两种可靠方案实现全量文件获取，无需依赖单提交的文件遍历。

不需要逐提交遍历，直接通过Git分支差异拿到MR全量变更，一次命令就能拿到和MR页面完全一致的变更文件列表。

• 核心逻辑：MR本质是将源分支从「和目标分支的分叉点」开始的所有变更合并到目标分支，因此找到两分支的共同分叉点，diff到源分支HEAD的范围，就是MR待合并的全部文件，不存在漏判。
• 具体实现步骤：
  • 第一步在流水线环境拉取目标分支的最新Git引用
  • 第二步计算两分支的merge-base（共同祖先提交）
  • 第三步通过diff命令拿到该范围内的所有变更文件
• 改造后的脚本示例：

script {
    // 拉取MR目标分支的本地引用
    sh(script: "git fetch origin ${CI_MERGE_REQUEST_TARGET_BRANCH_NAME}")
    // 计算全量变更文件列表
    def changedFiles = sh(
        returnStdout: true,
        script: "git diff --name-only \$(git merge-base origin/${CI_MERGE_REQUEST_TARGET_BRANCH_NAME} HEAD) HEAD"
    ).trim().split("\n").findAll { it.length() > 0 }

    if (changedFiles.any { it.endsWith(".sql") }) {
        println "[INFO] Adding merge request comment..."
        addGitLabMRComment comment: "Merge request contains SQL files."
    } else {
        println "[INFO] No SQL files found in the merge request. Omitting..."
    }
}

• 优势：
  • 不依赖旧版GitLab插件的自定义变量，使用GitLab原生的MR预置变量即可兼容大多数版本
  • 不会重复统计同一文件在多次提交中的重复变更，一次拿到去重后的全量文件
  • 计算范围和MR页面展示的变更完全匹配，不会把MR创建后目标分支新增的变更误算为MR的内容

如果需要逐提交做校验（比如校验单提交的提交信息、变更范围规范），可以通过GitLab原生API拿到和MR页面完全一致的提交列表：

• 核心接口：使用流水线内置的Job Token调用GitLab API，请求当前MR的提交列表接口，返回的提交顺序、范围和MR页面「提交」标签页展示的内容完全一致
• 实现逻辑：
  • 接口路径为/api/v4/projects/${CI_PROJECT_ID}/merge_requests/${CI_MERGE_REQUEST_IID}/commits
  • 拿到返回的所有commit哈希后，遍历每个哈希执行原来的git diff-tree命令获取单提交的变更文件
  • 对所有收集到的文件做去重后做统一校验
• 适用场景：该方式适合需要逐提交校验的场景，如果仅需要校验MR的全量变更文件，方案1的效率和准确率更高

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