解决Springboot项目打成jar包后获取resources目录下的文件失败的问题

前几天在项目读取resources目录下的文件时碰到一个小坑，明明在本地是可以正常运行的，但是一发到测试环境就报错了，说找不到文件，报错信息是：class path resource [xxxx] cannot be resolved to absolute file path because it does not reside in the file system: jar:file:xxxx.jar!/BOOT-INF/classes!xxxx。

看了半天代码感觉没有问题，于是怀疑是打成项目jar包后和原项目存在差异导致的。于是我把的项目打成jar包，在本地直接调试jar，果然发现问题所在。下面我将以一个自己的测试项目api-test替代原来的公司项目来讲述一下排查过程。

一、项目代码

GetResourceTest：

public class GetResourceTest {
    public InputStream getResource1() throws IOException {
        File file = new DefaultResourceLoader().getResource("/template/qiankuan.ftl").getFile();
        return Files.newInputStream(file.toPath());
    }

    public InputStream getResource2() throws IOException {
        ResourcePatternResolver resolver = new PathMatchingResourcePatternResolver();
        Resource[] resources = resolver.getResources("/template/qiankuan.ftl");
        Resource resource = resources[0];
        return resource.getInputStream();
    }
}

TestController：

@RestController
@RequestMapping("/test")
public class TestController {
    @GetMapping(value = "/getResource")
    @ResponseBody
    public void getResource() throws IOException {
        GetResourceTest getResourceTest = new GetResourceTest();
        getResourceTest.getResource1();
    }
}

二、排查过程

1、首先使用Maven的install命令将项目打成jar包

命令执行成功后再target目录下就生成了jar包

2、在Termininal里cd到target目录下，然后执行下面的代码，9992可以替换成其他端口

java -jar -Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=9992 api-test-1.0.0-SNAPSHOT.jar

执行成功如下

3、添加远程调试

依次点击菜单Run,点击Edit Configurations，点击+，点击Remote JVM Debug，端口后改成刚刚设置的9992。

4、请求接口

请求测试接口，9991是项目原来的端口

127.0.0.1:9991/test/getResource

5、请求结果

请求果然报错了，报错和之前测试环境的报错一摸一样。其实我们通过这个报错已经可以大致上看出问题了。。。

6、断点调试

在请求的入口打上断点开始断点调试

通过断点调试也可以看到这个文件地址在原来的地址/template/qiankuan.ftl 前拼接了jar:file:/D:/Project/test/fhey-test/api-test/target/api-test-1.0.0-SNAPSHOT.jar!/BOOT-INF/classes!成为了jar:file:/D:/Project/test/fhey-test/api-test/target/api-test-1.0.0-SNAPSHOT.jar!/BOOT-INF/classes!/template/qiankuan.ftl。

然后在后面一段代码中，resourceUrl.getProtocol()的返回结果是"jar"而不是"file"， 被判定为不是文件然后抛出了一个FileNotFoundException异常。

三、解决方法

ResouceUtils.getFile()是专门用来加载非压缩和Jar包文件类型的资源,所以它根本不会去尝试加载Jar中的文件，要想加载Jar中的文件，只要用可以读取jar中文件的方式加载即可，比如 可以采用ClassPathResource这种以流的形式读取文件的方式或者PathMatchingResourcePatternResolver来读取文件。

ClassPathResource classPathResource = new ClassPathResource("/template/qiankuan.ftl" );
InputStream inputStream = classPathResource.getInputStream();

或者

ResourcePatternResolver resolver = new PathMatchingResourcePatternResolver();
Resource[] resources = resolver.getResources("/template/qiankuan.ftl");
Resource resource = resources[0];
InputStream inputStream = resource.getInputStream();