FileNotFoundException不是运行时异常,而是IOException的子类,属于受检异常,必须显式捕获或声明throws。

FileNotFoundException到底是不是运行时异常
FileNotFoundException 是 IOException 的子类,属于受检异常(checked exception),不是 RuntimeException。这意味着编译器强制你处理它——要么用 try-catch 捕获,要么在方法签名中用 throws 声明。
常见误判是把它当运行时异常忽略,结果编译失败。尤其在 IDE 自动补全时容易漏掉 throws 或包裹逻辑。
- 不处理会直接报错:
unreported exception java.io.FileNotFoundException; must be caught or declared to be thrown - 如果确定文件一定存在(比如打包进 JAR 的资源),仍需处理——因为 JVM 不信你的“确定”
- 用
try-with-resources时,FileNotFoundException可能在构造资源时抛出,不在自动关闭的范围内,得在外层捕获
用FileInputStream读文件时怎么安全捕获
直接 new FileInputStream("config.txt") 最容易触发 FileNotFoundException。关键是区分“文件不存在”和“其他 IO 错误”,避免一锅端地吞掉所有异常。
try (FileInputStream fis = new FileInputStream("config.txt")) {
// 正常读取
} catch (FileNotFoundException e) {
// 单独处理:记录 warn,加载默认配置,或抛出自定义异常如 ConfigLoadException
logger.warn("config.txt not found, using defaults", e);
loadDefaultConfig();
} catch (IOException e) {
// 其他 IO 问题(如权限不足、磁盘满)走这里
throw new RuntimeException("Failed to read config", e);
}
- 不要只写
catch (Exception e)—— 会掩盖异常语义 - 注意
FileInputStream构造器抛出的是FileNotFoundException,不是IOException的泛化类型 - 路径用相对路径时,当前工作目录不一定是项目根目录,建议用
getClass().getResource()加载 classpath 资源
用Files工具类读取时为何还会抛这个异常
Files.readAllBytes(Paths.get("data.bin")) 看似简洁,但它底层仍会抛 IOException,而 FileNotFoundException 是其具体子类。JDK 7+ 的 NIO.2 并未绕过这个检查。
立即学习“Java免费学习笔记(深入)”;
-
Files.exists(path)返回false不等于一定会抛FileNotFoundException(可能被并发删除) -
Files.readString(path)(JDK 11+)同样受检,必须处理 - 若想静默忽略缺失文件,可先用
Files.exists()判断,但要注意竞态条件——判断和读取之间文件可能被删
Path path = Paths.get("user.json");
if (Files.exists(path)) {
try {
String content = Files.readString(path);
// 处理内容
} catch (IOException e) {
// 这里可能是权限错误、编码问题等,不是“找不到”
throw new UncheckedIOException(e);
}
} else {
// 明确处理缺失场景,比如返回空对象或默认值
return User.defaultUser();
}
Spring Boot里读配置文件的特殊处理
Spring 的 @Value 或 @ConfigurationProperties 不会抛 FileNotFoundException,因为它们依赖 ResourceLoader,对 classpath 资源做抽象。但如果你手动用 Resource.getFile(),就又回到原点——可能抛出该异常。
-
resource.getFile()在 jar 包中运行时会失败(因为资源不在文件系统),应改用resource.getInputStream() -
ClassPathResource的getFile()同样危险;getInputStream()才是安全的 fallback 方式 - 用
@Value("classpath:missing.properties")时,如果文件不存在,Spring 默认注入 null 或抛IllegalArgumentException,不是FileNotFoundException
真正需要自己处理 FileNotFoundException 的场景,往往出现在 Spring 封装之外的底层 IO 操作,比如导出报表写入本地磁盘、解析用户上传的外部配置文件等。










