为何Jenkins流水线中Groovy共享库的类静态方法未执行？

问题场景 #

已配置名为"foo"的Groovy共享库，目录结构如下：

+- src                       # Groovy source files
|   +- org
|       +- company
|           +- Stage.groovy  # for org.company.Stage class
+- vars
    +- func.groovy           # for global var func()

共享库文件内容：

src/org/company/Stage.groovy #

package org.company;

class Stage implements Serializable {
  static def func(d) {
    println("org.company.Stage.func()")
  }
}

vars/func.groovy #

def func(d) {
  println("func.groovy:func()")
}

流水线Jenkinsfile代码：

// Jenkinsfile
pipeline {
  agent any

    stages {
      stage('1') {
        steps {
          testLoadLib()
        }
      }
    }
}

void testLoadLib() {
  loadLibrary('foo@dev')
}

void loadLibrary(String libraryName) {
  def lib = library(libraryName)
  def d = [:]
  func.func(d)
  lib.org.company.Stage.func(d)
}

执行后控制台仅输出全局变量方法的内容：

Loading library foo@dev
...
[Pipeline] echo
func.groovy:func()
[Pipeline] }
[Pipeline] // stage
[Pipeline] }
[Pipeline] // withEnv
[Pipeline] }
[Pipeline] // node
[Pipeline] End of Pipeline

类静态方法既无报错也无输出，需排查原因并解决。

问题原因 #

1. 全局变量生效逻辑：vars目录下的func.groovy会被Jenkins自动注册为流水线全局变量，因此func.func(d)能直接调用并执行。
2. 静态方法调用错误：library()方法返回的是共享库的变量绑定对象，而非类路径命名空间。lib.org.company.Stage这种写法会尝试从变量绑定中逐层获取属性，由于不存在对应属性，最终返回null。在Jenkins的CPS执行环境中，调用null的方法不会抛出异常，而是静默跳过执行，因此既无输出也无报错。

解决方案 #

方案1：使用注解加载库+显式导入类 #

通过@Library注解加载共享库，直接导入目标类后调用静态方法：

// Jenkinsfile
@Library('foo@dev') _
import org.company.Stage

pipeline {
  agent any

    stages {
      stage('1') {
        steps {
          script {
            def d = [:]
            func.func(d)
            // 直接调用类静态方法
            Stage.func(d)
          }
        }
      }
    }
}

方案2：动态加载时通过类加载器获取类 #

如果需要动态加载库（比如用library()方法），通过共享库的类加载器加载目标类后调用：

void loadLibrary(String libraryName) {
  def lib = library(libraryName)
  def d = [:]
  func.func(d)
  // 通过类加载器加载类并调用静态方法
  Class stageClass = lib.getClassLoader().loadClass('org.company.Stage')
  stageClass.func(d)
}

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