Spring 深度解析：掃描規則、過濾器與最佳實踐

核心功能

<context:component-scan base-package="com.example" /> 會自動掃描基礎包及其子包下的類，發現帶有 @Component、@Controller、@Service、@Repository 等註解的類，自動註冊為 Spring Bean。
注意：已包含 <context:annotation-config/> 功能，無需重複配置。

屬性 use-default-filters

默認 true：掃描所有標準註解（@Component 及其子註解）。設為 false 可關閉默認掃描，配合子標簽精確控制。

子標簽：include-filter / exclude-filter

典型場景與配置

1. 僅掃描 Controller

2. 排除特定子包

3. 組合：關閉默認，精確包含/排除

常見誤區

• 未設 use-default-filters="false" 時，include-filter 為疊加而非替換，默認掃描仍生效。
• 多個 component-scan 重複掃描同一包導致 Bean 重複註冊（同名覆蓋或拋出異常）。
• 掃描範圍過大（如 base-package="com"）啟動慢、誤註冊第三方類。

最佳實踐

1. 按模組劃分基礎包，每模組一個 component-scan。
2. 生產環境建議 use-default-filters="false" 顯式聲明需掃描的註解類型。
3. 利用 exclude-filter 剔除測試代碼、舊模組、配置類等非業務 Bean。
4. 配合 @ComponentScan 註解在配置類上使用（Spring Boot 風格），類型安全且支持 IDE 重構。