在 IDE 里点运行,通知模板读得出来。把服务打成 JAR,放到服务器再启动,同一段代码却报 FileNotFoundException。先拿正在部署的那个包查一眼。文件有没有进包,以及程序打开的是包内条目还是磁盘上的文件,靠这两处信息就能把范围缩小。
下面用 Spring Boot 3.x、Maven 和 JDK 17 举例。项目通过 Spring Boot Maven 插件打出可用 java -jar 启动的包,示例资源 templates/notice.txt 属于应用模块。检查命令用 Linux 的 Bash。
先看部署的 JAR 里有没有文件
Maven 的常规目录下,源文件在 src/main/resources/templates/notice.txt,处理资源后进入 target/classes/templates/notice.txt。Spring Boot 再打成可执行 JAR 时,应用自己的类和资源放进 BOOT-INF/classes/。先对部署版本执行下面的命令,把示例文件名换成实际的 JAR 名。如果服务跑在容器里,确认手上的 JAR 与镜像里启动的那份一致。Maven 标准目录 · Spring Boot 可执行 JAR 结构
app_jar=target/demo-0.0.1-SNAPSHOT.jar
jar --list --file "$app_jar" | grep -iF 'notice.txt'
检查输出里有没有完整的 BOOT-INF/classes/templates/notice.txt,包括大小写。能找到同名文件时,还得对一下上一级目录。看到 Notice.txt 或 templates/mail/notice.txt,就用包里的准确路径再对照 Java 代码。如果 jar 自己先报错,先核对文件名和归档能否打开。
没找到条目时,再往构建过程倒查。target/classes 也没有,通常要看资源是否放在当前模块的 src/main/resources、POM 有没有自定义 resources 或排除规则。target/classes 有、发布的包里没有,就回头核对实际上传的是哪个模块、哪个构建产物。资源如果来自依赖模块,还要到 BOOT-INF/lib/ 对应的依赖 JAR 里查。打包命令和产物如何对应,可以对照本站 SpringBoot 教程的打包运行一节和 Spring Boot Maven 插件的 repackage 说明。
文件已经进包,就看调用栈怎么打开它
常见的一处是代码里还写着 new File("src/main/resources/templates/notice.txt")。这条相对路径从进程工作目录开始找。在 IDE 里启动时,工作目录通常还在项目附近。部署目录下如果没有那棵源码目录,JAR 里有同名条目也帮不上忙。
另一处更容易漏看。资源是用 ClassPathResource 找到的,接下来却调用了 getFile()。IDE 展开运行时,那个资源可能确实是 target/classes 下的磁盘文件。进了 JAR 以后,它成了归档里的条目。Javadoc 明确说明了 getFile() 的文件系统前提。读包里的小模板时,直接从资源打开输入流即可。ClassPathResource Javadoc
package demo;
import java.io.IOException;
import java.io.InputStream;
import java.nio.charset.StandardCharsets;
import org.springframework.core.io.ClassPathResource;
public final class NoticeReader {
public String readNotice() throws IOException {
var resource = new ClassPathResource("templates/notice.txt");
try (InputStream input = resource.getInputStream()) {
return new String(input.readAllBytes(), StandardCharsets.UTF_8);
}
}
}
传给 ClassPathResource 的路径从 classpath 根开始写,例子里是 templates/notice.txt。前面的 src/main/resources/ 是源目录,BOOT-INF/classes/ 是包内布局,两段前缀都留给构建和启动器处理。这里假定模板是小的 UTF-8 文本。资源很大时,按业务需要用缓冲流分段处理,readAllBytes() 会一次把内容读进内存。
本地用 JDK 17 和 Spring Boot 3.3.5 打了一个最小的可执行 JAR,从空目录启动。这个样例里,jar --list 找到了 BOOT-INF/classes/templates/notice.txt,getFile() 抛出 FileNotFoundException,上面的 getInputStream() 读取到了预期的模板内容。
发布后要换文件,就给它单独一个路径
随版本一起发的默认模板可以打进包。运营需要临时替换的模板,可以让服务读取配置里指定的绝对路径,比如 /etc/demo/notice.txt,然后用 Files.newBufferedReader 或 Files.newInputStream 打开。部署在容器里时,先确认文件已经挂载到容器内同一个路径,再确认应用运行用户有读取权限。查路径时,可以在启动日志里记下实际读取的位置。
如果问题只出现在 systemd 或 Docker 启动时,也一并看进程的工作目录。两个环境下同一个相对路径解析到了哪里,找出来再决定改读包内资源还是改外置配置。
换个目录拿发布包复测一次
用测试环境和相同的外部配置,从一个空目录启动刚打好的包。下面假设 Linux 上的构建产物已经存在,并且有空闲的测试端口。启动后触发原来读取模板的接口或任务,再看实际拿到的内容。
app_jar="$(realpath target/demo-0.0.1-SNAPSHOT.jar)"
run_dir="$(mktemp -d)"
(cd "$run_dir" && java -jar "$app_jar")
如果随包模板在这个目录下也能读出来,说明这条路径已经脱离项目源码目录。外置文件则可以在测试环境换一份内容再访问一次,确认程序读到的是配置指定的那份文件。
Spring Boot 本地能读文件,打成 JAR 怎么找不到了
https://java.li/archives/spring-boot-jar-resource-not-found
评论