Jenkins流水线中操作Map变量时为何整体变为null？

问题原因 #

Jenkins脚本控制台使用标准Groovy运行环境，而流水线中的Groovy代码会经过CPS（Continuation Passing Style）转换——这是Jenkins为实现流水线暂停、恢复和持久化而做的特殊处理。

在标准Groovy中，map[key] = null只是将指定键的值设为null，其他键值对不受影响；但流水线中，被CPS包装的Map对象（为了序列化和上下文持久化）对null赋值的处理存在异常，会直接清空整个Map，这就是你看到serverMappingAfterClear = [:]的原因。

解决方案 #

避免直接修改流水线上下文传递过来的Map，而是创建一个独立的Map副本进行操作，绕过CPS对原Map的特殊处理。同时可以调整逻辑，避免使用null标记，改用更安全的集合操作：

修改后的方法代码 #

private Map processServerMapping(Map serverMapping, List newVersions) {
    // 创建原Map的独立副本，脱离流水线CPS包装
    def workingMap = new LinkedHashMap<>(serverMapping)
    def currentVersions = workingMap.values().toSet()
    def removedVersions = currentVersions - newVersions.toSet()

    if (removedVersions) {
        def newVersionsToAssign = newVersions - currentVersions
        // 筛选出需要替换版本的服务器
        def serversToReplace = workingMap.findAll { _, version ->
            removedVersions.contains(version)
        }.keySet().toList()

        // 移除旧版本映射，再分配新版本
        serversToReplace.eachWithIndex { server, index ->
            if (index < newVersionsToAssign.size()) {
                workingMap[server] = newVersionsToAssign[index]
            } else {
                // 如果新版本数量不足，移除该服务器的映射（或根据需求保留为null）
                workingMap.remove(server)
            }
        }
    }
    return workingMap
}

关键调整点 #

1. 创建Map副本：用new LinkedHashMap<>(serverMapping)复制原Map，避免直接操作流水线上下文的CPS包装对象。
2. 简化逻辑：跳过赋值null的步骤，直接将需要替换的服务器映射更新为新版本，减少异常操作的可能性。
3. 边界处理：增加了新版本数量不足时的处理（可根据实际需求调整，比如保留为null或移除）。

验证效果 #

在流水线中调用修改后的方法，会返回正确的映射结果，不会出现Map被清空的问题，行为与脚本控制台保持一致。

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