Jenkins声明式流水线如何处理复制工件时可能不存在的分支？

没错，在声明式Jenkins流水线里处理这种「分支匹配优先、失败回退到master」的工件拉取需求，确实得借助script块来嵌入脚本式流水线的逻辑——毕竟声明式本身的结构化语法糖没办法直接覆盖这种灵活的条件判断和错误处理场景，这也是这类问题的标准解决方案。

我给你两种实用的实现思路，你可以根据自己的场景选择：

方案一：尝试优先分支，失败自动回退（更鲁棒） #

这种方式直接尝试拉取当前分支的工件，捕获失败异常后再回退到master，不仅能处理「分支不存在」的情况，还能覆盖「分支存在但没有成功构建工件」的场景，实用性更强：

pipeline {
    agent any
    stages {
        stage('Fetch Upstream Artifacts') {
            steps {
                script {
                    def gotArtifacts = false
                    // 先尝试匹配当前分支
                    try {
                        copyArtifacts(
                            projectName: "upstream_library/${BRANCH_NAME}",
                            selector: lastSuccessful()
                        )
                        gotArtifacts = true
                        echo "✅ 成功从分支 ${BRANCH_NAME} 获取工件"
                    } catch (Exception e) {
                        echo "⚠️ 从分支 ${BRANCH_NAME} 获取工件失败：${e.getMessage()}"
                        echo "🔄 准备回退到master分支..."
                    }

                    // 如果优先分支失败，拉取master的工件
                    if (!gotArtifacts) {
                        copyArtifacts(
                            projectName: "upstream_library/master",
                            selector: lastSuccessful()
                        )
                        echo "✅ 成功从master分支获取工件"
                    }
                }
            }
        }
        // 后续业务阶段...
    }
}

方案二：先检测分支存在性，再选择拉取目标 #

如果你只想针对「分支不存在」的情况回退，可以先检测上游多分支项目里是否存在对应分支，再决定拉取哪个分支的工件：

pipeline {
    agent any
    stages {
        stage('Fetch Upstream Artifacts') {
            steps {
                script {
                    // 获取上游多分支项目实例
                    def upstreamMultiBranch = jenkins.model.Jenkins.instance.getItemByFullName("upstream_library")
                    // 检查是否存在匹配的分支
                    def hasMatchingBranch = upstreamMultiBranch.getItems().any { it.name == BRANCH_NAME }
                    // 确定目标分支
                    def targetBranch = hasMatchingBranch ? BRANCH_NAME : 'master'

                    echo "🎯 将从分支 ${targetBranch} 获取工件"
                    copyArtifacts(
                        projectName: "upstream_library/${targetBranch}",
                        selector: lastSuccessful()
                    )
                }
            }
        }
    }
}

⚠️ 注意：第二种方案需要确保Jenkins的全局安全配置允许流水线脚本访问Jenkins实例（可能需要在「脚本审批」里通过相关权限），而且它只检测分支是否存在，不保证该分支有成功构建的工件，所以如果你的上游分支可能存在但未构建，还是第一种方案更稳妥。

总结一下：声明式流水线本身无法直接处理这类自定义错误捕获或分支检查逻辑，必须通过script块嵌入脚本式代码来实现，这是Jenkins官方认可的混合使用方式，完全不用担心合规性问题。

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