Groovy多文件共享变量问题：Jenkins脚本传递字符串列表

一、@Field注解的错误用法 #

你当前的@Field使用有两个核心问题：

1. 大小写错误：Groovy的注解是@Field（大写F），你写的@field是小写，这会直接导致语法错误。
2. 作用域错误：@Field需要声明在闭包/方法外部，才能将变量提升为脚本级全局变量。你把它放在call方法内部，完全发挥不了作用。

即使修正这两个问题，辅助脚本也无法直接访问主脚本的全局变量——因为Jenkins中主脚本和辅助脚本是独立的执行上下文，默认不共享变量。

二、不推荐用@Field传递列表的原因 #

@Field本质是创建脚本级全局变量，但在Jenkins多构建并发场景下，全局变量会存在并发污染风险（不同构建的变量互相覆盖）。而且这种方式违背模块化设计，函数依赖不明确，后期维护和调试难度大。

三、正确的实现方式：参数传递 #

最稳妥且符合Groovy/Jenkins最佳实践的方式，是将错误/警告列表作为参数直接传递给辅助函数。因为Groovy中列表是引用类型，辅助函数对列表的修改会直接反映到主脚本中。

主脚本（main.groovy）修改：

// Required to check for changes to input decks
import java.text.SimpleDateFormat
import java.util.Calendar
import hudson.tasks.Mailer
import hudson.model.User

// 先加载辅助脚本
def helper = load 'helper.groovy'

// This is the default project template
def call(body) {
  // evaluate the body block, and collect configuration into the object
  def pipelineParams = [:]
  body.resolveStrategy = Closure.DELEGATE_FIRST
  body.delegate = pipelineParams
  body()

  // 初始化消息列表
  List<String> errorMessages = []
  List<String> warningMessages = []
  List<String> verboseMessages = []

  // 调用辅助函数时，把需要的列表作为参数传入
  helper.checkMultiModule(folder, pathToFolder, buildModules, warningMessages)

  // 后续可以直接使用修改后的列表
  println "检测到警告：${warningMessages}"
}

辅助脚本（helper.groovy）修改：

#!usr/bin/env groovy
import java.text.SimpleDateFormat
import groovy.time.TimeCategory
import java.io.File

// 新增参数：接收主脚本传入的警告列表
def checkMultiModule(String folder, String pathToFolder, List<String> buildModules, List<String> warningMessages) {
  // ... 原有检测逻辑代码 ...

  // 当模块未找到时，向传入的列表添加警告信息
  if (!allModulesFound) {
      testFile.delete()
      // 用Groovy的GString简化字符串拼接，更易读
      warningMessages.add("Warning: Module ${testName} requires ${requiredModules}. So the module tests were not executed")
  }
  print "Multi-module ${testName} requires ${requiredModules} found = ${allModulesFound}"
}

四、额外优化建议 #

• 如果你需要传递多个列表（错误、警告、 verbose），可以把它们封装到一个Map中，减少参数数量：

  // 主脚本中
  def messageMaps = [
    errors: [],
    warnings: [],
    verboses: []
  ]
  helper.checkMultiModule(folder, pathToFolder, buildModules, messageMaps)
  
  // 辅助脚本中
  def checkMultiModule(String folder, String pathToFolder, List<String> buildModules, Map messageMaps) {
      messageMaps.warnings.add("xxx")
  }
  

• 避免使用ArrayList<>()初始化列表，Groovy中直接用[]更简洁，且默认就是ArrayList类型。

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