IDEA 啟動 Spring 項目報 BeanDefinitionStoreException 與 NoClassDefFoundError：配置文件路徑與依賴傳遞檢查

錯誤堆棧核心

BeanDefinitionStoreException: Error registering bean 'LuceneContext' ... 
depends on not found; nested exception is NoClassDefFoundError: org/apache/lucene/index/CorruptIndexException
...
NoClassDefFoundError: Could not initialize class com.trs.components.common.publish.widget.LayoutMgr

原因分析

1. 依賴傳遞缺失：LuceneContext 依賴 Lucene 核心包，但項目中未正確引入 lucene-core JAR (或版本不匹配)，導致 CorruptIndexException 類找不到。
2. 靜態初始化失敗：LayoutMgr 類靜態塊/字段初始化拋出異常 (如缺少配置文件、依賴 Bean 未就緒)，導致 NoClassDefFoundError: Could not initialize class。
3. 配置文件路徑錯誤：Spring 配置文件 (如 applicationContext.xml) 未放在 src/main/resources 或未在 web.xml contextConfigLocation 正確指定，導致 Bean 定義未加載。

排查步驟

1. Maven 依賴檢查：mvn dependency:tree | grep lucene 確認 lucene-core 版本存在且無衝突。
2. IDEA 模塊設置：File → Project Structure → Modules → Dependencies，確認 Lucene JAR 勾選「Export」。
3. 靜態初始化排查：查看 LayoutMgr 源碼靜態塊，嘗試延遲初始化或添加異常捕獲。
4. 配置文件：確保 web.xml 中 contextConfigLocation 指向正確路徑 (如 classpath*:applicationContext*.xml)。

快速驗證

執行 mvn clean compile dependency:copy-dependencies 檢查輸出 target/dependency 中是否包含 Lucene JAR。