Jenkins Pipeline Groovy目录检测代码返回false求助

这个坑我之前踩过！你代码里的核心问题是在Jenkins Pipeline中直接使用了Java的new File()类，这在分布式构建环境下完全行不通。

为什么会失效？ #

Jenkins是分布式架构，当你运行Pipeline时，实际的构建工作是在agent（构建节点）上完成的，而new File()是在Jenkins master节点的文件系统中查找路径——你的目标目录明明在agent的工作空间里，master上当然找不到，所以file.isDirectory()会返回false。

正确的解决方法 #

推荐两种跨平台、适配Jenkins分布式环境的方案：

方案1：用Pipeline内置的findFiles步骤（最推荐）

findFiles是Jenkins专门为Pipeline提供的文件操作步骤，会在当前agent节点执行，能准确判断路径类型：

def folderExists(folderName) {
    def targetFiles = findFiles(glob: folderName)
    if (targetFiles.size() > 0) {
        def isDirectory = targetFiles[0].isDirectory()
        echo "file/folder exists: ${folderName}"
        echo "Is directory: ${isDirectory}"
        return isDirectory
    } else {
        echo "Not found: ${folderName}"
        return false
    }
}

方案2：用shell/bat命令判断（适配复杂场景）

如果需要更灵活的判断逻辑，可以通过sh（Linux/macOS）或bat（Windows）命令在agent节点执行系统级的目录检测：

def folderExists(folderName) {
    def exists = fileExists(folderName)
    if (exists) {
        // Linux/macOS 版本
        def isDir = sh(
            script: "[ -d '${folderName}' ] && echo 'true' || echo 'false'",
            returnStdout: true
        ).trim() == 'true'
        
        // 如果是Windows节点，替换成下面的bat命令
        // def isDir = bat(
        //     script: "if exist \"${folderName}\" (if exist \"${folderName}\\\" (echo true) else (echo false)) else (echo false)",
        //     returnStdout: true
        // ).trim() == 'true'
        
        echo "file/folder exists: ${folderName}"
        echo "Is directory: ${isDir}"
        return isDir
    } else {
        echo "Not found: ${folderName}"
        return false
    }
}

重要提醒 #

在Jenkins Pipeline中，**永远不要直接使用Java IO类（比如new File()、FileInputStream）**操作构建相关的文件/目录，除非你明确要操作Jenkins master节点本地的文件——这些类不会感知到agent节点的存在，大概率会导致不符合预期的结果。

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