Tomcat 找不到專案配置文件的解決方案

問題現象

部署 Java Web 應用至 Tomcat 時，伺服器無法載入專案的配置文件（如 web.xml、Spring 配置等），導致應用啟動失敗或功能異常。

常見原因與解決步驟

1. 配置文件未放入正確路徑

確認配置文件位於 WEB-INF/ 或 WEB-INF/classes/ 目錄下。若使用 Maven，檢查 pom.xml 中 <resources> 設定是否包含配置文件。

2. 類別路徑缺失

若配置文件需透過類別路徑載入（如 classpath:applicationContext.xml），請確認編譯輸出目錄（target/classes）已包含該文件，且部署至 Tomcat 的 WEB-INF/classes 中。

3. Spring ContextLoaderListener 未註冊

參考 StackOverflow 相關討論：
Cannot resolve No WebApplicationContext found
Spring No WebApplicationContext found

在 web.xml 中添加：

<listener>
    <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>
<context-param>
    <param-name>contextConfigLocation</param-name>
    <param-value>classpath:applicationContext.xml</param-value>
</context-param>

4. 部署結構錯誤

檢查 WAR 包結構或 Tomcat webapps/ 下的展開目錄，確保 WEB-INF/web.xml 存在且格式正確。

參考資源

部落格文章：Tomcat 配置文件載入問題分析