Jenkins共享库不支持Groovy @Delegate注解报错求助

我之前碰到过类似的问题，在你使用的Jenkins 2.89.4 + workflow-cps 2.42这个版本组合里，自定义Bindings类的@Delegate注解正是触发CPS转换异常的核心原因。

问题根源 #

旧版本的workflow-cps插件对Groovy的@Delegate注解支持存在缺陷，当CPS机制尝试转换带有委托注解的类时，无法正确解析其字节码结构，进而抛出Unsupported expression for CPS transformation异常。

可行的解决方案 #

方案1：移除@Delegate，手动实现所需方法

既然委托注解是问题的导火索，我们可以直接去掉它，手动实现Map的必要方法，让CPS能正确识别类的结构。修改后的Bindings类代码如下：

final class Bindings implements Serializable {
    private final Map map

    Bindings(Map map) {
        this.map = map
    }

    @Override
    boolean containsKey(Object key) {
        return true
    }

    @Override
    Object get(Object key) {
        return map.getOrDefault(key, null)
    }

    // 按需添加其他Map方法，比如put、size等
    Object put(Object key, Object value) {
        return map.put(key, value)
    }
}

修改完成后再运行你的实例化代码，异常应该就能消失。

方案2：升级workflow-cps插件版本

后续版本的workflow-cps插件（比如2.60及以上）修复了大量CPS转换的兼容性问题，其中就包括对@Delegate注解的支持优化。如果你的Jenkins 2.89.4兼容更高版本的插件，可以尝试升级到稳定版（比如2.70），升级前记得先在测试环境验证兼容性，避免影响现有流水线的正常运行。

方案3：改用动态实现替代自定义类

如果你的Bindings类只是为了实现containsKey始终返回true和get方法的默认值逻辑，完全可以用Groovy的动态特性替代自定义类，比如直接用Map模拟：

def map = ["key":"value"]
def bindings = [
    containsKey: { key -> true },
    get: { key -> map.getOrDefault(key, null) }
] as Map

或者用Expando实现：

def map = ["key":"value"]
def bindings = new Expando()
bindings.containsKey = { key -> true }
bindings.get = { key -> map.getOrDefault(key, null) }

这种方式更适配Jenkins的CPS机制，不会触发转换异常。

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