本文介绍了在 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() 更加可靠，是推荐的做法。 记住添加判空处理和异常处理，确保代码的健壮性。
