SpringBoot部署Docker-Compose Tomcat时静态文件路径异常排查

问题原因分析 #

1. 空指针异常：报错显示ServletContext为null，说明代码中调用getRealPath时，ServletContext未被正确初始化或注入，触发空指针。
2. 路径无效：本地开发使用的src/main/webapp/files/images/alergenos是IDE项目路径，部署到Docker的Tomcat后，该路径在容器内不存在；且war包部署时静态资源的存储结构与本地开发环境完全不同，直接用File类访问资源在war包未解压的环境下会失效。

解决方案 #

1. 正确注入ServletContext（解决空指针） #

在Controller中通过@Autowired注入ServletContext，确保对象被Spring容器正确初始化：

@Controller
public class MainController {
    @Autowired
    private ServletContext servletContext;

    // 其他业务方法...
}

2. 用Spring资源访问机制替代File类 #

Spring提供的ResourceLoader/Resource接口可适配本地开发与容器部署环境，避免依赖磁盘文件路径：

@Controller
public class MainController {
    @Autowired
    private ResourceLoader resourceLoader;

    public ArrayList<Alergenos> getAlergenos() {
        ArrayList<Alergenos> toReturn = new ArrayList<>();
        try {
            // 读取classpath下的静态资源目录（推荐将资源放在src/main/resources/static下）
            Resource resourceDir = resourceLoader.getResource("classpath:static/files/images/alergenos");
            File folder = resourceDir.getFile();
            File[] listOfFiles = folder.listFiles();
            
            if (listOfFiles != null) {
                for (File listOfFile : listOfFiles) {
                    if (listOfFile.isFile()) {
                        toReturn.add(
                                new Alergenos(
                                        removeSlash(
                                                listOfFile.getName().substring(listOfFile.getName().indexOf("a_"), listOfFile.getName().indexOf(".png"))
                                        ),
                                        listOfFile.getName()
                                )
                        );
                    }
                }
            }
        } catch (IOException e) {
            e.printStackTrace();
            // 处理资源读取异常
        }
        return toReturn;
    }

    // 你的removeSlash方法...
}

3. 调整静态资源存放位置（推荐） #

将静态资源从src/main/webapp迁移到src/main/resources/static目录，这是SpringBoot默认的静态资源路径，打包后会自动纳入classpath，无需额外配置即可访问。

4. 动态获取应用上下文路径（适配war包部署） #

若坚持使用webapp目录，需通过ServletContext动态获取真实路径，避免硬编码应用名称：

// 获取应用上下文路径
String contextPath = servletContext.getContextPath();
// 获取资源的真实磁盘路径
String realPath = servletContext.getRealPath("/files/images/alergenos");
File folder = new File(realPath);

注意：getRealPath在war包未解压的环境下可能返回null，优先推荐Spring的Resource机制。

关键注意事项 #

• 禁止硬编码路径，所有资源路径通过Spring API动态获取，适配不同部署环境。
• 不要直接用File类访问classpath内的资源，容器化环境中资源可能存在于压缩包内，File无法直接访问。
• 确保Docker-Compose中Tomcat容器正确部署war包，应用上下文路径配置匹配。

内容的提问来源于stack exchange，提问作者Mariano Fernández Rodero