Jenkins Pipeline配置远程触发报错：无法识别pipelineTriggers

问题场景 #

将Jenkins自由风格任务的远程构建配置迁移至Pipeline时，使用以下代码出现报错：

node {
    properties([pipelineTriggers([[$class: 'RemoteBuildConfiguration', remoteBuildToken: 'w6d7e8f4s']])])
}

错误信息：
no known implementation of interface java.util.List is using symbol ‘pipelineTriggers’

错误原因 #

1. 类名不匹配：自由风格任务中使用的RemoteBuildConfiguration类，在Pipeline语法中对应的正确类是RemoteBuildTrigger
2. 参数结构错误：pipelineTriggers需要作为properties方法的一个参数元素，内部嵌套触发器配置列表

解决方案 #

方案1：使用项目级持久化触发器（推荐） #

通过properties方法配置项目级别的远程构建触发器，配置会保存到Jenkins项目设置中：

node {
    properties([
        pipelineTriggers([
            [$class: 'RemoteBuildTrigger', token: 'w6d7e8f4s']
        ])
    ])
    // 这里添加你的构建步骤
    echo '执行构建任务...'
}

方案2：使用Pipeline DSL简化语法 #

Jenkins提供了简化的DSL语法，直接用remoteBuild快捷指令定义触发器：

node {
    triggers {
        remoteBuild('w6d7e8f4s')
    }
    // 这里添加你的构建步骤
    echo '执行构建任务...'
}

两种方案说明 #

• 方案1的配置会持久化到Jenkins项目中，即使Pipeline脚本修改，触发器设置仍会保留
• 方案2的触发器仅在当前Pipeline运行时生效，更适合临时或动态调整的场景

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