Spring SSH ContextLoaderListener 啟動失敗：applicationContext.xml 路徑問題排查

錯誤堆棧核心

FileNotFoundException: Could not open ServletContext resource [/WEB-INF/applicationContext.xml]

根本原因

Spring 容器啟動時，ContextLoaderListener 默認從 /WEB-INF/applicationContext.xml 加載配置，但實際部署路徑中找不到該文件。

排查清單

1. 文件是否存在：打開 WAR 包或部署目錄，確認 WEB-INF/applicationContext.xml 物理存在。
2. web.xml 配置：contextConfigLocation 參數是否正確？

<context-param>
    <param-name>contextConfigLocation</param-name>
    <param-value>/WEB-INF/applicationContext.xml</param-value> <!-- 默認值，可省略 -->
</context-param>
<listener>
    <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>

3. 構建輸出：Maven/Gradle 打包時是否將 src/main/webapp/WEB-INF 下資源複製到 target/.../WEB-INF？檢查 pom.xml <resources> 配置。
4. 服務器發布：Eclipse/IDEA 部署配置（Deployment Assembly / Artifacts）是否包含該文件？
5. Clean & Rebuild：mvn clean package，刪除服務器部署目錄重新發布。
6. 大小寫敏感：Linux 服務器區分大小寫，確認文件名完全匹配。

快速驗證

// 在 ServletContextListener 中打印真實路徑
public class DebugListener implements ServletContextListener {
    public void contextInitialized(ServletContextEvent sce) {
        String path = sce.getServletContext().getRealPath("/WEB-INF/applicationContext.xml");
        System.out.println("Real path: " + path); // null 表示未部署
    }
}

總結

90% 為**構建/部署配置導致文件未進入 WAR**，而非代碼邏輯錯誤。依次檢查：源文件位置 → 打包配置 → 服務器發布配置 → Clean Rebuild。