Jenkinsfile中changeset指令在嵌套文件夹下失效问题求助

针对你遇到的changeset指令在嵌套文件夹场景下始终跳过阶段的问题，可按照以下步骤排查和解决：

1. 先确认Jenkins识别的变更文件路径 #

问题核心往往是你预期的路径和Jenkins实际识别的路径不一致。先添加一个调试阶段，打印出所有变更文件的实际路径：

pipeline {
    agent any;
    stages {
        stage('Debug Changed Files') {
            steps {
                script {
                    // 打印Jenkins内置的变更集合路径
                    currentBuild.changeSets.each { cs ->
                        cs.each { change ->
                            println "Jenkins detected changed path: ${change.path}"
                        }
                    }
                    // 用Git命令直接输出变更文件（更直观）
                    sh 'git diff --name-only HEAD^ HEAD'
                }
            }
        }
        stage('run with condition') {
            when {
                changeset "folderA/folderB/**"
            }
            steps {
                echo "Executing..."
            }
        }
    }
}

运行流水线后，查看控制台输出的路径，这是调整changeset匹配规则的关键依据。

2. 常见路径不匹配的原因及修正 #

（1）Jenkinsfile位置导致路径偏移 #

如果你的Jenkinsfile不是放在项目根目录（比如放在folderA下），Jenkins工作区的根目录会自动切换到Jenkinsfile所在的目录，此时变更文件的路径会变成folderB/example.txt，而非folderA/folderB/example.txt。这种情况下，需要将匹配模式改为：

changeset "folderB/**"

（2）路径大小写不匹配 #

changeset的路径匹配是大小写敏感的，确认你的匹配模式和实际文件路径的大小写完全一致（比如FolderA和folderA会被视为不同路径）。

（3）旧版本Jenkins的兼容性问题 #

如果你的Jenkins版本低于2.220，changeset对嵌套路径的**匹配可能存在bug，建议升级到较新版本的Jenkins及Pipeline插件。

（4）合并提交的变更未被识别 #

如果你的变更是通过合并分支引入的，默认changeset只会识别当前分支的直接提交，此时可以添加compareRemote参数指定对比基准：

when {
    changeset(compareRemote: 'origin/main', pattern: "folderA/folderB/**")
}

3. 验证修正后的匹配模式 #

根据调试阶段获取的实际路径，调整changeset的模式后重新运行流水线，确认阶段是否正常触发。比如调试输出路径为folderA/folderB/example.txt，使用folderA/folderB/**即可匹配所有该目录下的变更文件。

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