Jenkinsfile使用when关键字时，修改requirements.txt却跳过Create Jira Ticket阶段的问题排查

我来帮你排查这个问题，你遇到的情况在Jenkins声明式流水线里挺常见的，大概率是changeset条件的匹配逻辑或者语法细节没处理对，咱们一步步来分析：

首先，确认Jenkins是否真的识别到了requirements.txt的变更 #

有时候Jenkins的变更集识别可能和咱们预期的不一样，你可以先加一个调试阶段，打印出当前构建的所有变更文件，看看是否包含目标文件：

stage('Debug Changed Files') {
    steps {
        script {
            def changedFiles = currentBuild.changeSets.flatMap { it.items }.flatMap { it.affectedFiles }.collect { it.path }
            echo "本次构建变更的文件列表：${changedFiles}"
        }
    }
}

运行构建后，查看这个阶段的输出，确认requirements.txt是否在列表里。如果不在，那可能是变更没有被Jenkins捕获（比如分支选择错误、上一次构建已经包含该变更等）；如果在，那就是when条件的写法有问题。

常见的changeset条件写法问题及修复 #

你的原始代码里用了when {changeset "requirements.txt"}，这个简写语法在某些场景下会因为匹配规则的问题失效，咱们可以调整成更明确的写法：

1. 精确匹配根目录的requirements.txt

如果你的requirements.txt确实在仓库根目录，使用完整的changeset语法指定精确匹配：

stage('Create Jira Ticket') {
    when {
        changeset pattern: 'requirements.txt', comparator: 'EXACT'
    }
    steps {
        jiraTicketCreator()
    }
}

2. 匹配任意目录下的requirements.txt

如果你的requirements.txt可能在子目录里，或者不确定路径，可以用GLOB模式匹配：

stage('Create Jira Ticket') {
    when {
        changeset pattern: '**/requirements.txt', comparator: 'GLOB'
    }
    steps {
        jiraTicketCreator()
    }
}

3. 更灵活的自定义检查（推荐）

如果上面的写法还是不生效，可以用expression块自定义变更检查逻辑，这种方式更透明：

stage('Create Jira Ticket') {
    when {
        expression {
            // 提取所有变更文件的路径
            def changedFiles = currentBuild.changeSets.flatMap { it.items }.flatMap { it.affectedFiles }.collect { it.path }
            // 判断是否包含目标文件
            return changedFiles.contains('requirements.txt')
            // 如果是子目录，就改成 return changedFiles.any { it.endsWith('/requirements.txt') }
        }
    }
    steps {
        jiraTicketCreator()
    }
}

其他可能的排查点 #

• 确认你的Jenkins版本：有些旧版本的Jenkins对changeset简写语法的支持有bug，升级到较新的LTS版本可能解决问题。
• 检查流水线的分支配置：如果是多分支流水线，确认当前运行的分支确实包含requirements.txt的变更。
• 上一次构建状态：如果上一次成功构建已经包含了这次的requirements.txt修改，那么changeset条件会判断为无新变更，跳过阶段。

备注：内容来源于stack exchange，提问作者kahhengchong