Spring MVC web.xml 配置 DispatcherServlet 初始化報錯：CommonInterceptor 類未找到

錯誤現象

在 web.xml 配置 DispatcherServlet 後啟動報錯，移除該配置則正常。錯誤堆棧提示 CommonInterceptor 類未找到 (ClassNotFoundException)。

原因分析

DispatcherServlet 初始化時會加載 Spring MVC 配置文件 (如 spring-mvc.xml)，該配置中引用了 CommonInterceptor (攔截器)，但類路徑下找不到該類：

• 類名拼寫錯誤或包路徑錯誤。
• 編譯未輸出該類 (未勾選模塊、輸出目錄錯誤)。
• 依賴的 JAR 包缺失 (若攔截器在第三方庫中)。

排查步驟

1. 檢查 Spring MVC XML 中 <mvc:interceptors> 配置的類全限定名。
2. 在 IDE 中搜索 CommonInterceptor 確認存在且編譯無誤。
3. 查看部署後的 WEB-INF/classes 或 lib 是否包含該類文件。
4. 若為 Maven 項目，執行 mvn clean compile 重新編譯。

快速驗證

暫時註釋掉攔截器配置，若啟動正常，確定為該類缺失問題。