在Java项目里处理文件检索时，我们经常会碰到一种需求：已知路径的前缀和后缀，但中间恰好有一层目录名是动态生成的、无法直接写死。比如日志存放在 /data/app_*/logs/error.log 这样的结构中，app_* 就是单层未知目录。如何精准且高效地把它找出来，是很多实际业务里的刚需。
为什么不能用简单的递归全扫
最直观的想法是写一个递归方法，从根目录开始遍历每一个子目录，遇到目录就继续往下，直到拼出完整路径再去判断文件是否存在。这种做法在小规模目录树下勉强能用，但一旦根目录层级深、文件多，就会触发大量无意义的 listFiles 或 Files.list 调用，把不需要的目录也全部打开一遍，系统IO和CPU占用都会飙升。
另一个隐藏问题是，全盘递归很容易陷入符号链接环。如果某个中间目录是软链且指向了父级，程序可能无限循环直至栈溢出或磁盘耗尽。因此在只关心“单层未知”这种明确结构时，应当使用更收敛的匹配策略，而不是无差别下降。
基于PathMatcher的glob单层匹配
Java NIO的 FileSystem.getPathMatcher 支持glob语法，其中 * 正好可以匹配不含路径分隔符的任意字符序列，也就是单层名称。我们可以先用 Files.newDirectoryStream 列出已知父目录下的直接子项，再用 * 过滤出那一层未知目录，随后进入其中拼接后续固定路径。
下面示例展示如何查找 /data/app_*/logs/error.log 这类文件。注意glob中的 app_* 只匹配 /data 的正下级，不会跨层。
import java.nio.file.*;
import java.io.IOException;
import java.util.ArrayList;
import java.util.List;
public class SingleLevelWildcard {
public static List<Path> findErrorLogs(Path dataDir) throws IOException {
List<Path> result = new ArrayList<>();
// 只列出dataDir的直接子目录，用glob匹配单层未知目录名
PathMatcher matcher = FileSystems.getDefault().getPathMatcher("glob:app_*");
try (DirectoryStream<Path> stream = Files.newDirectoryStream(dataDir)) {
for (Path child : stream) {
if (Files.isDirectory(child) && matcher.matches(child.getFileName())) {
Path target = child.resolve("logs").resolve("error.log");
if (Files.exists(target)) {
result.add(target);
}
}
}
}
return result;
}
public static void main(String[] args) throws IOException {
Path data = Paths.get("/data");
List<Path> logs = findErrorLogs(data);
logs.forEach(System.out::println);
}
}
代码关键点说明
上述代码里，newDirectoryStream(dataDir) 没有传过滤参数，是因为我们想自己控制匹配逻辑，当然也可以写成 Files.newDirectoryStream(dataDir, "app_*") 让JDK直接帮我们筛出单层目录。使用 getFileName() 是为了拿纯名称去比glob，因为glob默认是针对完整路径的，直接传全路径会匹配失败。
在拿到候选未知目录后，用 resolve 拼接后续固定层级，而不是字符串硬拼，能避免不同系统的分隔符问题。最后用 Files.exists 确认目标，不假设目录里一定有日志文件。
常见误区与正确做法
不少开发者误以为写成 glob:app_*/logs/error.log 丢给 PathMatcher 就能一步到位，实际上标准glob匹配是针对单个路径串的，不能自动帮你遍历中间那层。你必须先展开 app_* 这一级，再手动进到里面。另一个误区是用 ** 代替 *，** 代表跨任意多层，会把结构放得太宽，既慢又容易命中错误路径。
如果业务允许，推荐用 Files.newDirectoryStream(dir, "app_*") 直接在流层面过滤，减少Java层循环判断。遇到符号链接时，可改用 Files.walk 并加 LinkOption.NOFOLLOW_LINKS 做更严格的控制，但这已超出单层通配的简单场景。
性能与使用建议
相比从 /data 开始 Files.walk 全量遍历，单层匹配只展开一层目录，假设 /data 下有10个应用目录，每个里面上百个子文件，全扫可能要打开上千个句柄，而单层方案仅打开10个目录加10次文件存在性检查，开销直线下降。
在写工具类时，建议把未知层表达式和后续固定路径都作为参数传入，做成通用方法。同时捕获 AccessDeniedException 之类的异常，防止某个目录无权限读取就中断整个查找。这样代码既清晰又健壮，能覆盖大多数单层未知目录的匹配查找需要。