Spring Boot Web应用中如何遍历文件？遇URI非层级异常求解

嘿，这个问题我之前踩过坑！你遇到的URI is not hierarchical异常，本质原因是：当你的Spring Boot应用打包成Jar包后，classpath:responses/files下的资源是嵌入在Jar内部的，并不是文件系统上的独立目录/文件。这时候ClassPathResource.getURI()返回的是类似jar:file:/xxx.jar!/responses/files的特殊URI，它不符合File类要求的层级化文件系统路径格式，所以直接转File就会报错。

下面给你两种靠谱的解决方案，覆盖开发和生产环境：

方案一：通用兼容方案（推荐） #

用Spring提供的ResourcePatternResolver来遍历资源，它能同时处理文件系统中的资源和Jar包内的资源，不需要区分环境：

import org.springframework.core.io.Resource;
import org.springframework.core.io.support.ResourcePatternResolver;
import org.springframework.core.io.support.PathMatchingResourcePatternResolver;
import java.io.InputStream;
import java.nio.charset.StandardCharsets;

// 在你的业务代码中
ResourcePatternResolver resolver = new PathMatchingResourcePatternResolver();
// 匹配classpath下responses/files目录下的所有文件（包括子目录）
Resource[] resources = resolver.getResources("classpath:responses/files/**");

for (Resource resource : resources) {
    // 获取文件名
    String filename = resource.getFilename();
    System.out.println("找到文件：" + filename);
    
    // 读取文件内容（示例）
    try (InputStream inputStream = resource.getInputStream()) {
        String content = new String(inputStream.readAllBytes(), StandardCharsets.UTF_8);
        // 这里写你的业务逻辑，比如解析内容、处理文件等
    } catch (Exception e) {
        e.printStackTrace();
    }
}

方案二：区分环境的兼容方案 #

如果你的场景需要在开发环境直接操作File对象（比如本地调试时），可以先判断资源是否存在于文件系统中，再分别处理：

import org.springframework.core.io.ClassPathResource;
import org.springframework.core.io.Resource;
import org.springframework.core.io.support.ResourcePatternResolver;
import org.springframework.core.io.support.PathMatchingResourcePatternResolver;

ClassPathResource resourceDir = new ClassPathResource("responses/files");
if (resourceDir.isFile()) {
    // 开发环境：资源在本地文件系统中，直接用File操作
    File dir = resourceDir.getFile();
    File[] files = dir.listFiles();
    if (files != null) {
        for (File file : files) {
            // 处理本地文件
            System.out.println("本地文件：" + file.getName());
        }
    }
} else {
    // 生产环境：资源在Jar包内，用ResourcePatternResolver处理
    ResourcePatternResolver resolver = new PathMatchingResourcePatternResolver();
    Resource[] resources = resolver.getResources("classpath:responses/files/**");
    for (Resource resource : resources) {
        // 处理Jar内资源
        System.out.println("Jar内文件：" + resource.getFilename());
    }
}

关键提醒 #

永远不要假设ClassPathResource对应的资源一定是文件系统中的文件——Spring Boot应用打包后，所有classpath资源都会被嵌入Jar，这时候File类完全无法处理这些资源，必须用Spring的Resource接口及其相关工具类来操作。

内容的提问来源于stack exchange，提问作者hudi