本文介绍如何正确读取 JAR 包内嵌目录（如 postman/）并遍历其中所有文件，重点解决 File 对象无法直接映射 JAR 内路径的难题，推荐使用 Java 7+ 的 FileSystem API 安全高效地完成资源枚举与内容读取。
在 Java 应用中，资源被打包进 JAR 文件后，传统基于 java.io.File 的路径操作便彻底失效——JAR 内部的目录并非真实文件系统的目录，而只是 ZIP 归档结构中的逻辑路径。你可能遇到过这样的场景：myFolder.exists() && myFolder.isDirectory() 返回 false，原因很简单——new File(...) 试图将 jar:file:/xxx.jar!/postman 这类 URL 解析成本地磁盘路径，而操作系统里根本不存在这样一个路径。
正确的做法是什么呢？利用 Java NIO.2 的 FileSystem API 将 JAR 文件挂载成虚拟文件系统，然后通过 Path 和 DirectoryStream 安全地遍历内部目录。下面是一套完整、可复用的实现方案：
import ja va.io.IOException;
import ja va.net.URI;
import ja va.nio.file.*;
import ja va.nio.file.attribute.BasicFileAttributes;
import ja va.util.HashMap;
import ja va.util.Map;
import ja va.util.stream.Collectors;
public class JarResourceReader {
/**
* 从 JAR 中读取指定目录下所有匹配模式的文件（如 *.json）
* @param jarResourcePath 类路径下的 JAR 资源路径（如 "/postman"）
* @param filePattern 文件匹配模式（如 "*.json"），支持 glob 语法
*/
public static void listFilesInJarFolder(String jarResourcePath, String filePattern) {
// 1. 获取 JAR 文件的绝对 URL（注意：必须是 jar:file: 协议）
var url = JarResourceReader.class.getResource(jarResourcePath);
if (url == null || !url.getProtocol().equals("jar")) {
throw new IllegalArgumentException("Resource not found or not in JAR: " + jarResourcePath);
}
try {
// 2. 构建 JAR 文件 URI（提取 jar:file:... 部分）
URI jarUri = URI.create(url.toString().split("!")[0]);
// 3. 创建只读 FileSystem（避免创建临时文件系统）
Map env = new HashMap<>();
env.put("create", "false"); // 关键：设为 false，避免意外写入
try (FileSystem jarFs = FileSystems.newFileSystem(jarUri, env)) {
// 4. 定位到目标目录（注意：路径以 / 开头，且需与 JAR 内实际结构一致）
Path targetDir = jarFs.getPath("/postman"); // ✅ 确保与 JAR 内路径完全匹配
// 5. 遍历并处理文件
try (DirectoryStream stream = Files.newDirectoryStream(targetDir, filePattern)) {
for (Path path : stream) {
if (Files.isRegularFile(path)) {
System.out.println("Found file: " + path);
// 示例：读取 JSON 内容
String content = Files.readString(path);
System.out.println("Content length: " + content.length());
}
}
}
}
} catch (IOException e) {
throw new RuntimeException("Failed to read resources from JAR", e);
}
}
// 使用示例
public static void main(String[] args) {
listFilesInJarFolder("/postman", "*.json");
}
}
这里有几个关键点值得留意：
- 路径格式必须准确：
jarFs.getPath("/postman")中的/postman是 JAR 内的绝对路径（根为 JAR 包顶层），不能写成"postman"或"./postman"； - 协议校验不可省略：确保
getResource()返回的是jar:协议 URL，否则FileSystems.newFileSystem()会抛出异常； - 及时关闭资源：FileSystem 和 DirectoryStream 都需要显式关闭（推荐使用 try-with-resources 语法）；
- 别再用 File 构造：JAR 内路径永远无法转换成有效的
java.io.File实例，这是设计限制，并非代码缺陷； - 如果 JAR 来源不可信，建议对 jarUri 做白名单校验，防止路径穿越或恶意 URI 注入。
补充一个小技巧：如果想抓取所有文件（不限扩展名），只需将 filePattern 改为 "*" 即可；如果需要递归遍历子目录，可以用 Files.walk() 替代 DirectoryStream，但要理解 JAR 内部并没有真正的“子目录”概念，仅依赖路径前缀匹配。
采用这套方案，你不仅能可靠列出 postman/ 下所有的 JSON 文件，还能直接读取内容、解析结构，甚至按需复制到临时目录进一步处理——彻底绕开 File API 的限制，拥抱现代 Java 的模块化资源访问能力。
