Java读取JAR包内相对路径CSV文件触发FileNotFoundException
问题核心根因
反复触发FileNotFoundException的本质原因有两点:
- 你使用的
new FileInputStream(...)是面向操作系统物理磁盘文件的API,仅能读取磁盘上存在的独立文件。但CSV文件是打包在JAR压缩包内部的,不属于独立磁盘文件,不管怎么拼接磁盘相对/绝对路径,这个API都无法访问JAR包内的压缩资源,自然会持续抛出找不到文件的异常。 - 之前尝试的类资源读取写法存在规则混淆:
DateFormatUtils.class.getClass().getResource(...)等价于类加载器的资源检索逻辑,该逻辑默认从classpath根开始检索,且路径不能带开头斜杠;同时拿到虚拟路径后直接转文件路径的操作也存在问题——JAR内资源的检索路径是带jar:file:前缀的虚拟地址,不是操作系统可识别的真实物理路径,传给文件流API同样无法读取。
正确的JAR内资源读取方式
针对打包在JAR内部的资源文件,必须直接通过类加载器获取资源输入流,不能通过转物理路径、构造File对象的方式读取:
- 核心语法规则:使用
类名.class.getResourceAsStream(路径),如果要从classpath根目录检索,路径开头必须加斜杠。 - 不要尝试将资源路径转成
File对象,JAR内部的资源没有独立的磁盘物理路径,拿到输入流后直接传给后续的CSV解析逻辑即可。
修正方案
- 调整代码中的资源读取逻辑
可参考如下改写后的代码片段:public class DateFormatUtils { // 类路径下的资源路径,开头斜杠代表从classpath根目录检索 private static final String DATE_FORMAT_CSV_PATH = "/csv/country_date_format.csv"; public static String getDateFormatByLocale(Locale locale) { List<Map<String, String>> mapList = Collections.emptyList(); String fileExtension = "csv"; // 直接获取资源输入流,使用try-with-resources自动关闭流 try (InputStream inputStream = DateFormatUtils.class.getResourceAsStream(DATE_FORMAT_CSV_PATH)) { if (inputStream == null) { throw new IllegalStateException("类路径下未找到指定的日期格式配置CSV文件"); } mapList = ExcelUtils.read(inputStream, fileExtension); // 此处补充根据Locale匹配对应日期格式的业务逻辑 } catch (IOException e) { e.printStackTrace(); } return ""; } } - 确认资源文件的打包配置
如果使用Maven/Gradle构建项目,需要将csv目录放在src/main/resources路径下,构建工具才会自动将该目录下的所有文件复制到classpath根目录,最终打进JAR包。 - 校验JAR包内容
可以直接用解压工具打开生成的JAR文件,检查根目录下是否存在csv/country_date_format.csv文件。如果不存在,说明之前的资源目录放置位置不符合构建规则,需要调整后重新打包。
内容的提问来源于stack exchange,提问作者Jorel Amthor
相关产品推荐
相关产品推荐

