Heroku部署Spring Boot应用后无法识别CSS及静态txt文件求助

阿华AIGC实验室

2026-5-29

解决方案：Heroku部署后静态资源与资源文件加载失败问题

从你的描述来看，本地运行正常但Heroku上出现CSS和english.txt加载失败，这通常是静态资源路径配置和资源文件读取方式在打包部署环境下的适配问题，以下是针对性的解决步骤：

一、修复CSS静态资源加载问题

确认静态资源目录结构
Spring Boot默认会自动识别src/main/resources/static/、src/main/resources/public/等目录下的静态资源。请确保你的CSS文件放在正确的位置，比如：
```
src/main/resources/static/css/your-style.css
```
页面引用时使用正确的相对路径
在HTML页面中引用CSS时，使用根相对路径（不要用本地绝对路径或相对当前页面的路径），示例：
```
<link rel="stylesheet" href="/css/your-style.css">
```
验证Maven打包是否包含静态资源
检查你的pom.xml，确保没有自定义的<resources>配置排除了src/main/resources/static目录。默认情况下，Maven会自动将该目录下的文件打包到jar包中，若有自定义配置，需确保包含：
```
<resources>
    <resource>
        <directory>src/main/resources</directory>
        <includes>
            <include>**/*</include>
        </includes>
    </resource>
</resources>
```

二、修复`english.txt`文件读取失败问题

本地运行时你可能直接使用了文件系统路径（比如new File("english.txt")），但在Heroku上应用是以jar包形式运行的，内部文件无法通过File对象访问，必须通过类加载器读取classpath中的资源：

将english.txt放在正确位置
确保文件位于src/main/resources/根目录下，这样打包后会被放入classpath中。

修改读取代码为类加载器方式
替换原有的文件读取代码，使用类加载器获取输入流：

// 方式1：通过当前类的类加载器
InputStream inputStream = getClass().getResourceAsStream("/english.txt");
// 方式2：通过上下文类加载器（更通用，比如在静态方法中使用）
InputStream inputStream = Thread.currentThread().getContextClassLoader().getResourceAsStream("english.txt");

// 读取内容示例
if (inputStream == null) {
    throw new RuntimeException("english.txt文件未找到，请检查资源位置");
}
try (BufferedReader reader = new BufferedReader(new InputStreamReader(inputStream))) {
    String line;
    while ((line = reader.readLine()) != null) {
        // 处理每一行数据
    }
} catch (IOException e) {
    e.printStackTrace();
}