Groovy目录遍历未返回全部目录问题排查

我来帮你拆解下这个问题，大概率是权限限制或者遍历参数配置的问题，下面一步步排查和解决：

1. 核心原因分析 #

你遇到的只输出D:\$RECYCLE.BIN的情况，主要有两个可能：

• Jenkins运行用户权限不足：Jenkins主节点的服务是用特定账户身份运行的（比如默认的Local System账户），如果这个账户没有读取D:\Test、D:\Test2、D:\Test3的权限，Groovy的traverse方法就只能访问到它有权限的系统目录（比如回收站）。
• Groovy遍历的默认行为限制：虽然traverse默认会遍历子目录，但某些隐式过滤规则可能跳过了你的目标目录（不过回收站是隐藏目录却能显示，这个可能性相对小）。

2. 先做个排查测试 #

先运行一段简单代码，确认Jenkins运行用户能不能看到目标目录：

def rootDir = new File("D:/")
// 列出D盘根目录下的所有文件/目录
rootDir.listFiles().each { item ->
    println "发现：${item.path} | 是否为目录：${item.isDirectory()}"
}

如果运行后看不到你的Test系列目录，那肯定是权限问题；如果能看到，再调整traverse的参数配置。

3. 具体解决方案 #

方案一：修复Jenkins运行用户权限 #

• 打开Windows服务管理器，找到Jenkins服务，右键选择「属性」→「登录」标签页。
• 确认当前的登录账户，如果是Local System，建议换成一个拥有D盘根目录读取权限的本地用户或域用户。
• 重启Jenkins服务后，再运行你的脚本试试。

方案二：优化Groovy遍历代码 #

如果权限没问题，就调整traverse的参数，确保遍历所有目录：

import groovy.io.FileType

def rootDir = new File("D:/")
rootDir.traverse(
    type: FileType.DIRECTORIES,
    includeHidden: true, // 确保包含隐藏目录（可选，回收站已显示说明该参数默认生效）
    stopOnError: false,  // 遇到权限不足的目录时，继续遍历其他目录
    filter: { file -> 
        // 可选：过滤掉回收站这类系统目录，只保留你的目标目录
        !file.name.startsWith('$') 
    }
) { dir ->
    println dir.path
}

这里注意导入groovy.io.FileType避免类型识别问题；stopOnError: false可以防止遇到某个无权限目录就终止整个遍历流程。

4. 额外提示 #

如果你的Jenkins Pipeline是在Windows代理节点运行，还要确认节点代理服务的运行用户同样拥有对应权限；另外，尽量用new File("D:/")的方式创建File对象，比字符串强制转换更清晰可靠。

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