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

淡淡的烟草味﹌ 2024-03-17 17:00 62阅读 0赞

前几天在项目读取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包 ####

![b3d9db158a16de0780d0c670e55a1013.png][]

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

![93e66d019be26ada16f1b159ee0c625f.png][]

#### 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

执行成功如下

![4284345daff21feadd8cfab1613d0d2d.png][]

#### 3、添加远程调试 ####

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

![91a61e82a1a1cecffdd3bf2a568b1eeb.png][]

#### 4、请求接口 ####

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

127.0.0.1:9991/test/getResource

#### 5、请求结果 ####

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

![c9cb5deef9ded869cd3bc2f766140221.png][]

#### 6、断点调试 ####

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

![093fd50163892a20ee85b1757cabc47c.png][]

通过断点调试也可以看到这个文件地址在原来的地址/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。

![3e617fb49ebc0c8d9d019eb68706c459.png][]

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

![80622e475bd214637aea2b30d2f7660b.png][]

## 三、解决方法 ##

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();

[b3d9db158a16de0780d0c670e55a1013.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/15/05da99abd0554fd7880a2be471bfcba3.png
[93e66d019be26ada16f1b159ee0c625f.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/15/139dd95e011f4428a7808835fdf56f7c.png
[4284345daff21feadd8cfab1613d0d2d.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/15/bf34de2082304e52899eb3a1355d2a46.png
[91a61e82a1a1cecffdd3bf2a568b1eeb.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/15/6b6c5db6fa0841df8fe343b79de6823d.png
[c9cb5deef9ded869cd3bc2f766140221.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/15/24de368ff84540068b33fa36200e543c.png
[093fd50163892a20ee85b1757cabc47c.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/15/3dacfe28140140f4913e9127f55f1dc9.png
[3e617fb49ebc0c8d9d019eb68706c459.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/15/fa7110452d3c43c19e8a8e986271e365.png
[80622e475bd214637aea2b30d2f7660b.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/15/c4a6a6a0e36d48a4ae08cd482093f614.png