當你的 Spring 項目出現「本地復現不了」「配置生效順序不明」「事務狀態難判斷」「Bean 注入鏈條太長」時，傳統斷點只讓你盯著一片樹葉。

IntelliJ IDEA Ultimate 的 Spring Debugger 能把整片「森林」攤開：哪個 Bean 被實例化、配置最終值是什么、數據庫連接與事務此刻處于什么狀態，你都能在 IDE 里一眼看清。

它把運行時細節可視化，幫助你更快定位問題、驗證應用狀態，進而寫出更穩定、可維護的代碼?？梢园阉斫鉃槟?Spring 應用的運行時“X 光機”。

---

Spring Debugger 到底是啥？

這是 IntelliJ IDEA Ultimate（2025.2+）提供的針對 Spring 的調試增強能力。只要進入 Debug，會在編輯器、Debugger 工具窗口與項目視圖中「活體顯示」Spring 運行時信息：ApplicationContext、配置屬性、數據源、事務、Bean 狀態等。

你會收獲：

• 更快定位：可視化直達問題根因，少走彎路。
• 更準驗證：運行時即看即得，配置值與 Bean 狀態當場確認。
• 更穩交付：減少盲試錯，提升代碼與配置的可維護性。

注意：需要 IntelliJ IDEA Ultimate；社區版不支持。

---

怎么啟用（兩步搞定）

1. Ctrl + Alt + S 打開設置 → 插件（Plugins）→ 搜索并安裝「Spring Debugger」。若提示，重啟 IDE。
2. 用 Debug 模式運行你的 Spring 應用，即可體驗所有能力。

---

能力一：配置“最終值”回顯與來源追蹤（搞清楚到底哪個值生效）

痛點：.properties/.yml 多來源、占位符與覆蓋鏈一長串，最后誰生效？

Spring Debugger 會在編輯器相應行顯示運行時的「最終值」，并支持跳轉查看“誰覆蓋了誰”。

圖：編輯器內直接顯示屬性的最終運行時值

你可以這樣試：

在 application.properties：

my.test.value=from-properties

在 application-dev.properties：

my.test.value=from-dev

以 Debug 啟動并激活 dev：--spring.profiles.active=dev（也可在 application.properties 中指定）。

圖：同一屬性在不同配置源下的最終值對比

更妙的是，若代碼里在運行時更新了配置值（比如 Environment/ConfigurablePropertyResolver 相關邏輯），最新值也會直接顯示，并且可以一鍵跳轉到“覆蓋它”的那段代碼位置。

圖：從最終值快速導航到覆蓋來源

---

能力二：Bean 一覽無余（誰加載了、誰沒加載、誰是 Mock）

在調試模式下運行應用時，Project 工具窗口會按 Spring 視角標注每個 Bean 的運行時狀態，加載與否一目了然：

圖標顏色含義：

• 綠色（green）— 已加載
• 透明（transparent）— 未加載
• 黃色（yellow）— Mock（模擬）

常見 Bean 類型（不同類型會用不同圖標標識，便于快速分辨）：

1. @Component / @Bean

• 自動發現的組件以及通過 @Bean 方法定義的 Bean。

2. @Configuration

• 配置類 Bean（@Configuration 或隱式包含該注解的類）。

3. @Repository

• 存儲庫 Bean（@Repository 或實現 org.springframework.data.repository.Repository）。

4. @Controller

• 控制器（@Controller / @RestController）。

5. 隱式 Bean（implicit beans）

• Spring 自帶且非顯式定義的基礎服務類 Bean。

6. 抽象 XML Bean

• 在 XML 中使用 abstract="true" 定義的抽象 Bean。

7. 基礎設施 Bean（infrastructure beans）

• 與配置/基礎設施支持相關的 XML Bean，如 ViewResolver 或 context:component-scan 相關。

8. 原型作用域 Bean

• 在 XML 中 scope="prototype" 定義的原型 Bean。

9. 其他 XML 定義的 Bean

• 除以上類別外的 XML Bean。

實戰價值：快速確認某個 Bean 是否被容器加載、是否被 Mock 替代、是否被排除，從而定位“為什么沒生效”。

---

能力三：數據庫連接自動發現（不配數據源也能看）

調試模式下，IDE 會在數據庫工具窗口自動展示應用當前使用的數據庫連接。適用于：

• 你還沒在 IDE 里配置數據源
• 多數據源/微服務場景
• 通過 Docker Compose 啟動的業務流程

啟動前：

啟動后：

• 用 Debug 運行 Spring 應用
• 打開數據庫工具窗口
• 點擊刷新

在發現出的數據庫上，你可以查看表、直接執行 SQL、瀏覽 schema，和普通數據源的體驗一致。

---

能力四：在 Debugger 表達式里直接用 Spring 上下文（隨取隨用）

調試時，無論當前棧幀里有沒有，你都可以在“計算表達式/監視”中訪問 Spring 的屬性與任意 Bean，直接調用其方法來取數、做假設驗證。

1）從編輯器直接計算或添加監視

• 按住 Alt，用鼠標點擊要計算的表達式
• 或選擇表達式后使用 Ctrl + Alt + F8 打開“計算表達式”
• 支持代碼補全，避免拼寫錯誤，寫得更快

2）在變量頁簽里評估任意表達式

• 在 Variables 的“評估表達式”輸入框中輸入，回車即可
• 可將結果加入“監視”，后續持續觀察

為了更方便查看集合/大對象，可以使用“探索元素”在獨立對話框分頁瀏覽與篩選；若結果是 JSON/XML 字符串，還能按結構化文檔方式折疊/導航。

3）直接評估 Spring 屬性

• 在表達式輸入框右側選擇「Spring Properties」
• 輸入屬性名并回車即可查看值與來源詳情
• 也可以把該屬性加入“監視”

4）把表達式用到斷點里（條件與臨時日志）

• 右鍵斷點，給“條件”填寫表達式，僅在滿足時才掛起
• 或者在“更多”里使用“評估并日志”，打印表達式結果但不打斷程序（可取消“掛起”）

---

能力五：把事務與實體狀態“攤開”給你看

當你調試的代碼運行在 JPA 事務里，Debugger 會顯示會話上下文，包括：隔離級別、傳播行為、緩存內容等。你還能直接看到 JPA 實體此刻到底是 managed 還是 detached。

怎么看事務詳情

• 在事務里的執行行掛起應用
• 打開“調試”工具窗口 → 切到“變量”頁簽 → 展開“事務”節點

還可以一鍵導航到“事務是從哪里開始的”。

對于事務中的 JPA 實體，會在“變量”頁簽與代碼引用位置展示它們的當前狀態，排查“為啥更新沒刷新/為啥變成了游離態”這類問題非常直觀。

---

需要時，也能一鍵禁用

如果某個 Run/Debug 配置不想啟用 Spring Debugger：

• 打開對應 Run/Debug 配置 → 點擊「修改選項」→ 勾選「禁用 Spring Debugger」。

---

什么時候特別有用？

• 配置值“說一套、跑一套”，需要快速確認最終值與來源
• Bean 鏈條復雜，不確定到底加載了誰/被誰替換了誰
• 多數據源或微服務場景，想直接看到實時連接并執行驗證 SQL
• 復雜斷點邏輯，想臨時打印/條件暫停而不改業務代碼
• 事務邊界模糊，JPA 實體狀態難斷

---

小結與行動

• 這是一套“在運行時看清一切”的調試新姿勢：配置、Bean、數據庫、表達式、事務，一個窗口看全局。
• 今天就裝上，用 Debug 打開你的項目，先挑一個最近卡住的小問題試試手：比如檢查一個配置是否真生效，或看某個 Bean 到底有沒有被加載。
• 如果這篇文章對你有用，轉給同事一起少踩坑；也歡迎留言說說你在項目里遇到的“看不清”的調試難題，我們一起把坑填平。