gradlew编译成功但未检查类路径符号问题咨询

你的理解完全正确：执行./gradlew build或./gradlew compileGroovy时确实只做了Groovy语法层面的校验，没有对pipeline、agent这类DSL符号做链接检查。

• Groovy本身是动态JVM语言，默认编译不会做严格的静态符号校验。只要代码语法没写错，哪怕你调用的方法、引用的变量压根不存在，编译也能正常通过，这类符号的解析会全部留到运行时，靠Groovy的元对象协议（MOP）动态处理。
• 当前编译依赖中没有Jenkins Pipeline相关类。你的build.gradle里只引入了Groovy核心包、Ivy包和JUnit测试包，完全没有引入Jenkins核心、Pipeline DSL相关的依赖包，编译阶段的类路径下本来就不存在pipeline、agent这类符号的定义，自然也没法做链接检查。
• Jenkins共享库本身采用运行时绑定设计。Jenkins Pipeline的DSL（包括pipeline、agent、stages这类关键字，以及logError这类自定义步骤）从设计上就是运行时动态注入的：共享库代码编译阶段不会和Jenkins运行时的类做静态链接，只有当共享库被Jenkins加载、实际执行流水线任务时，Pipeline执行引擎才会通过闭包委托、元方法注入的方式，把这些DSL方法绑定到代码的执行上下文里。

如果需要在编译/测试阶段提前发现DSL拼写错误、方法不存在这类问题，不能依赖默认的compileGroovy任务，通常有两种实现方案：

• 给需要校验的类/方法添加Groovy自带的@CompileStatic/@TypeChecked注解，开启静态编译检查。注意这种模式下需要在依赖中引入对应版本的Jenkins Pipeline API包，否则会直接报找不到方法的编译错误。
• 引入Jenkins官方的Pipeline单元测试框架，在单元测试阶段模拟Jenkins运行时上下文，执行流水线逻辑做校验，这也是Jenkins共享库开发最常用的校验方式。

问题中涉及的配置与代码 #

当前build.gradle配置 #

// Apply the groovy plugin to add support for groovy
apply plugin: 'groovy'

sourceSets {
    main {
        groovy {
            srcDirs = ['src', 'vars']
        }
    }
    test {
        groovy {
            srcDirs = ['test']
        }
    }
}
// In this section you declare where to find the dependencies of your project
repositories {
    // Use 'jcenter' for resolving your dependencies.
    jcenter()
    // You can declare any Maven/Ivy/file repository here.
    maven {
        url "https://repo.jenkins-ci.org/releases/"
    }
}

// In this section you declare the dependencies for your production and test code
dependencies {
    compile 'org.codehaus.groovy:groovy-all:2.5.6'
    compile 'org.apache.ivy:ivy:2.4.0'
    testCompile 'junit:junit:4.12'
}

vars目录下的示例代码 #

def call(Map params) {
    pipeline {
        agent none

        stages {
            stage('Build') {
                agent { label 'maven'}
                steps {
                    logError 'Hello world'
                }
            }
        }
    }
}

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