Groovy脚本在Jenkins控制台正常运行但作业Execute Groovy Script步骤执行失败

核心原因是Jenkins中两个Groovy执行入口的运行上下文完全不一致：

• Jenkins管理后台的脚本控制台运行在Jenkins Controller（主控节点）的JVM进程内，属于Jenkins内置的特权执行环境，默认自动导入Jenkins核心类、注入Jenkins单例实例，无需额外配置依赖就能直接调用Jenkins全量API。
• 构建步骤里的Execute Groovy Script逻辑是调用当前分配的构建节点（你的日志中显示为Buildsl从节点）本地安装的独立Groovy运行时执行脚本，运行环境完全脱离Jenkins JVM上下文：既没有自动注入的Jenkins全局属性，classpath里也没有加载Jenkins核心依赖包，哪怕手动添加导入语句，也会因为找不到对应依赖类无法运行。

构建日志里的执行命令[Vetus_node_checker] $ groovy C:\JS\workspace\node_checker\hudson633049885410603886.groovy可以直接验证该逻辑：这一步是直接调用节点本地的groovy命令执行工作目录下生成的临时脚本文件，和脚本控制台的执行逻辑没有任何关联。

根据脚本的实际用途选择对应方案即可：

• 如果脚本需要调用Jenkins API（比如查询节点状态、修改任务配置这类操作Jenkins本身的逻辑）：直接把现有构建步骤替换为Execute system Groovy script，这个步骤的执行环境和Jenkins脚本控制台完全一致，你原本在控制台跑通的代码无需任何修改就能正常执行。注意该步骤默认在Controller节点运行，需要操作从节点数据时直接通过Jenkins API获取对应节点对象即可，不需要依赖脚本运行在目标从节点上。
• 如果脚本不需要调用Jenkins API，只是执行普通Groovy业务逻辑：删除脚本中所有引用Jenkins实例、Jenkins专有类的代码即可，标准Groovy语法在Execute Groovy Script步骤中可以正常运行。
• 如果确实需要在从节点本地执行Groovy逻辑同时访问Jenkins能力：不要直接在脚本中引用Jenkins核心类，改用Jenkins REST API、Jenkins CLI或者Pipeline内置步骤实现即可。直接在从节点的独立Groovy脚本里硬连Jenkins实例需要手动处理依赖加载、权限认证，维护成本极高，不推荐使用。

内容的提问来源于stack exchange，提问作者Mads Sander Høgstrup