Jenkins Pipeline中Groovy静态类变量未被识别的问题排查

原因分析 #

• Jenkins Pipeline采用CPS（Continuations Passing Style）转换机制实现脚本异步执行，脚本会被拆分为多个独立执行步骤，每个步骤可能运行在不同的类加载器或执行上下文中。父类的静态变量状态无法在这些分散的上下文之间保持，导致每个子类实例访问时都会重新初始化静态变量。
• 本地Groovy运行在标准JVM上下文，静态变量属于类本身，所有子类实例共享同一个静态变量，因此只会触发一次初始化逻辑。

解决方案 #

方案1：依赖注入单例实例（推荐） #

去掉静态变量，通过构造方法将全局单例注入到每个Service实例，彻底避免上下文问题：

@Singleton
class EnvironmentMgr {
  String ecsCluster = "sandbox"
  // 其他属性和方法
}

abstract class EcsService {
  protected def envMgr

  EcsService(def envMgr) {
    this.envMgr = envMgr
  }

  def setup() {
    // 直接使用已注入的envMgr，无需判断null
  }
}

class Service1 extends EcsService {
  Service1(def envMgr) {
    super(envMgr)
  }

  def setup() {
    super.setup()
    // Service1专属逻辑
  }
}

class Service2 extends EcsService {
  Service2(def envMgr) {
    super(envMgr)
  }

  def setup() {
    super.setup()
    // Service2专属逻辑
  }
}

// 在Pipeline全局上下文初始化单例，统一注入给所有Service
def envMgr = EnvironmentMgr.instance
def svc1 = new Service1(envMgr)
svc1.setup()
def svc2 = new Service2(envMgr)
svc2.setup()

方案2：直接调用单例类的instance方法 #

既然EnvironmentMgr本身已经是单例，无需额外用静态变量缓存，直接在setup方法中调用EnvironmentMgr.instance即可，单例类会保证全局唯一实例：

@Singleton
class EnvironmentMgr {
  String ecsCluster = "sandbox"
  // 其他属性和方法
}

abstract class EcsService {
  def setup() {
    def envMgr = EnvironmentMgr.instance
    // 使用envMgr执行逻辑
  }
}

class Service1 extends EcsService {
  def setup() {
    super.setup()
    // Service1专属逻辑
  }
}

class Service2 extends EcsService {
  def setup() {
    super.setup()
    // Service2专属逻辑
  }
}

def svc1 = new Service1()
svc1.setup()
def svc2 = new Service2()
svc2.setup()

方案3：利用Jenkins全局上下文存储单例 #

通过currentBuild的环境变量存储单例实例，确保跨步骤的状态一致性：

@Singleton
class EnvironmentMgr {
  String ecsCluster = "sandbox"
  // 其他属性和方法
}

abstract class EcsService {
  def setup() {
    def envMgr = getEnvMgr()
    // 使用envMgr执行逻辑
  }

  private def getEnvMgr() {
    def instance = currentBuild.getEnvironment().get("ENV_MGR_INSTANCE")
    if (!instance) {
      println "envMgr is null"
      instance = EnvironmentMgr.instance
      currentBuild.setEnv("ENV_MGR_INSTANCE", instance)
    }
    return instance
  }
}

class Service1 extends EcsService {
  def setup() {
    super.setup()
    // Service1专属逻辑
  }
}

class Service2 extends EcsService {
  def setup() {
    super.setup()
    // Service2专属逻辑
  }
}

def svc1 = new Service1()
svc1.setup()
def svc2 = new Service2()
svc2.setup()

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