当前位置：首页 > 文章列表 > 文章 > java教程 > SpringBoot获取resources文件的几种方式

SpringBoot获取resources文件的几种方式

2025-07-15 20:54:42 0浏览收藏

哈喽！大家好，很高兴又见面了，我是golang学习网的一名作者，今天由我给大家带来一篇《Spring Boot 获取 resources 资源文件方法》，本文主要会讲到等等知识点，希望大家一起学习进步，也欢迎大家关注、点赞、收藏、转发! 下面就一起来看看吧！

Spring Boot 中获取 resources 目录下资源文件的正确方法

本文介绍了在 Spring Boot 项目中，如何可靠地从 resources 目录下读取资源文件内容。传统的 ClassLoader.getSystemResource() 方法在打包成 JAR 文件后可能会失效。本文提供了一种基于 Spring Framework 核心工具类的解决方案，确保在开发和部署环境中都能正确读取资源文件。

在 Spring Boot 项目中，resources 目录用于存放静态资源文件，如配置文件、模板文件、密钥文件等。在代码中读取这些资源文件是常见的需求。然而，使用 ClassLoader.getSystemResource() 方法在开发环境下可能有效，但当项目打包成 JAR 文件后，这种方法可能会失效，导致程序无法正常运行。这是因为 JAR 文件内部的资源访问方式与文件系统有所不同。

为了解决这个问题，我们可以利用 Spring Framework 提供的 ClassPathResource 和 FileCopyUtils 类。ClassPathResource 能够以统一的方式访问类路径下的资源，而 FileCopyUtils 则提供便捷的字节数组复制功能。

以下是一个工具方法，演示了如何使用 Spring Framework 来读取 resources 目录下的文件内容：

import org.springframework.core.io.ClassPathResource;
import org.springframework.util.FileCopyUtils;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import java.io.IOException;
import java.util.Objects;

public class ResourceUtil {

    private static final Logger log = LoggerFactory.getLogger(ResourceUtil.class);

    public static String getResourceFileContent(String resourcePath) {
        Objects.requireNonNull(resourcePath, "Resource path cannot be null");
        ClassPathResource resource = new ClassPathResource(resourcePath);
        try {
            byte[] bytes = FileCopyUtils.copyToByteArray(resource.getInputStream());
            return new String(bytes);
        } catch (IOException ex) {
            log.error("Failed to parse resource file: " + resourcePath, ex);
            return null; // 或者抛出异常，根据实际情况处理
        }
    }
}

代码解释：

引入必要的类: 引入 ClassPathResource 用于加载类路径下的资源, FileCopyUtils 用于将输入流复制到字节数组，以及日志相关的类。
getResourceFileContent(String resourcePath) 方法:
- 接收一个 resourcePath 参数，表示资源文件的路径，例如 "key/private.pem"。
- 使用 Objects.requireNonNull() 进行非空校验，确保 resourcePath 不为 null。
- 创建一个 ClassPathResource 对象，传入 resourcePath。
- 使用 FileCopyUtils.copyToByteArray(resource.getInputStream()) 将资源文件的内容读取到字节数组中。
- 将字节数组转换为字符串并返回。
- 如果发生 IOException，则记录错误日志并返回 null (或抛出异常，具体取决于您的错误处理策略)。

使用示例：

假设您有一个名为 private.pem 的文件，位于 resources/key/ 目录下，您可以使用以下代码读取其内容：

String privateKeyContent = ResourceUtil.getResourceFileContent("key/private.pem");

if (privateKeyContent != null) {
    // 使用 privateKeyContent 进行后续操作
    System.out.println("Private Key Content: " + privateKeyContent);
} else {
    System.err.println("Failed to load private key from resources.");
}

注意事项：

确保资源文件位于 resources 目录下或其子目录下。Spring Boot 会自动将 resources 目录添加到类路径中。
在调用 getResourceFileContent() 方法时，传入正确的资源文件路径。
根据实际需求，您可以选择在发生 IOException 时抛出异常，或者返回 null。
如果资源文件是二进制文件，则不要将其转换为字符串。直接使用字节数组即可。

总结：

通过使用 Spring Framework 提供的 ClassPathResource 和 FileCopyUtils 类，我们可以方便地从 Spring Boot 项目的 resources 目录下读取资源文件内容，并且能够保证在开发和部署环境中都能正确工作。这种方法比传统的 ClassLoader.getSystemResource() 更加可靠，是推荐的做法。记住添加判空处理和异常处理，确保代码的健壮性。

终于介绍完啦！小伙伴们，这篇关于《SpringBoot获取resources文件的几种方式》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！