
FileNotFoundException 本质是文件系统拒绝访问,不是 Java 的错
这个异常不意味着代码写错了,而是 JVM 在操作系统层面找文件时被挡住了。常见现象是本地开发能跑,部署到 Linux 服务器就报错;或者 IDE 里双击运行正常,用 java -jar 启动就炸——根本原因往往不在 Java 代码里,而在路径解析逻辑或进程权限上。
-
FileNotFoundException的 message 里显示的路径,是 Java 实际尝试打开的绝对路径(不是你写的相对路径),务必先打印出来确认 - 用
new File(path).getAbsolutePath()或Paths.get(path).toAbsolutePath()查真实路径,别靠猜 - Linux 下注意大小写:Windows 不敏感,Linux 敏感,
config.yml和Config.yml是两个文件 - 如果路径含中文或空格,确保 JVM 启动参数没丢
-Dfile.encoding=UTF-8,否则getResourceAsStream()可能静默失败
getResourceAsStream() vs new FileInputStream():选错就永远找不到
这是最常踩的坑:把类路径资源当文件系统路径用,或反过来。两者定位机制完全不同,混用必报错。
- 想读
src/main/resources/app.properties?必须用getClass().getResourceAsStream("/app.properties")—— 路径以/开头表示从 classpath 根开始 - 想读
/etc/myapp/config.json?只能用new FileInputStream("/etc/myapp/config.json"),且要确保运行 Java 的用户有读权限 -
getResource("")返回的是当前类所在包的 classpath 目录 URL,可用来推导资源根位置,但别直接拼字符串——不同打包方式(jar / war / exploded)结果不同 - JAR 包里用
getResourceAsStream()没问题;但用new File(...).exists()一定返回false,因为 JAR 内部不是文件系统目录
Linux 部署时权限和工作目录经常被忽略
Java 进程在 Linux 上通常以非 root 用户(如 appuser)运行,它看不到你 sudo 编辑过的文件,也进不去你手动 chown 错的目录。
- 检查 Java 进程实际工作目录:
ps aux | grep java找启动命令,再用ls -l /proc/PID/cwd看当前目录——很多“相对路径找不到”是因为 cwd 不是你以为的那个目录 - 用
ls -l /path/to/file确认文件存在,且运行 Java 的用户在该文件的所属组里,或至少有r--权限 - 目录权限同样重要:即使文件可读,父目录没有
--x(执行权限,即“可进入”),FileInputStream仍会报FileNotFoundException - SELinux 或 AppArmor 启用时,即使 chmod 755 也可能被拦截,临时用
setenforce 0测试是否是它在作祟
Spring Boot 中 file:classpath: 混用导致路径失效
Spring 的 file: 和 classpath: 前缀看着像能互换,其实语义严格隔离,写错一个字符就找不到。
立即学习“Java免费学习笔记(深入)”;
-
spring.config.location=file:/etc/myapp/application.yml—— 必须是绝对路径,且file:后不能跟相对路径,file:./config.yml在 Spring Boot 2.4+ 会被忽略 -
classpath:application.yml只搜 classpath(jar 包内、resources 目录等),不查文件系统;file:/opt/app/config.yml只查磁盘,classpath 里的同名文件完全无关 - 多个 location 用逗号分隔,但顺序影响覆盖规则:后加载的配置会覆盖前面的,别把
file:放在最后还指望它生效 - 用
logging.config=file:/var/log/myapp/logback-spring.xml时,确保该路径存在且可读,Spring 不会自动创建目录
路径和权限问题从来不是单点故障,而是文件系统、JVM、打包工具、部署环境四层叠加的结果。最容易被跳过的动作是:在出问题的机器上,切到 Java 进程用户,用 su - appuser,然后手动执行 cat /etc/myapp/config.yml —— 如果这一步都通不过,后面所有 Java 层的调试都是徒劳。










