通过 Spring Debugger 插件，IntelliJ IDEA 为标准调试器添加了 Spring 相关洞察，简化应用故障排查。
1. 简介
Spring Boot 通过少量依赖和最小配置，使构建强大应用变得很容易。只需几行代码，我们就可以设置 HTTP 端点、连接数据库并处理事件。这看起来像魔法——直到出现问题为止。
当出现问题时，调试就变得至关重要。但是，理解 Spring Boot 应用背后在运行时究竟发生了什么并不容易。配置值可能来自多个源，Bean 可能是有条件加载的，而且事务问题也很难定位。
在排查问题时，我们经常会问自己这样的问题：
- 实际使用的属性值是什么？
- 哪个 Bean 被注入了？
- 当前事务是否处于活动状态？
- 应用连接的是哪个数据库？
在本教程中，我们将探索 IntelliJ IDEA 的 Spring Debugger 插件 如何为标准调试器添加 Spring 相关洞察，并简化应用故障排查。
2. 通过 Spring Debugger 入门
Spring Debugger 不需要特殊配置——只需安装插件并在 调试模式（Debug） 下运行应用即可。
该插件支持以下运行配置类型：
- 原生 IntelliJ IDEA Spring Boot 运行
- Maven 的
spring-boot:run命令 - Gradle 的
bootRun任务 - 远程 attach 仍不支持
该插件与 IDE 内置的调试器 API 集成，不需要 Spring Boot Actuator 或其他额外库或代理。
安装完成后，我们就可以立即使用所有功能，查看应用在运行时内部发生了什么——从 Bean 开始。
3. 查看运行时加载了哪些 Bean
调试 Spring 应用时的第一个问题之一是：哪些 Bean 实际上被加载了？
Spring Debugger 在 Project 视图中添加了基于 Bean 类型的图标来表示不同状态：
- 🟢 绿色：已加载的 Bean
- ⚪ 灰色：扫描到但未加载的 Bean
- 🟠 橙色：被模拟（mock）的 Bean
这种可视化反馈对于测试或在有多个实现可用的情况下尤其有用。我们还可以在 “Evaluate Expression” 窗口中从当前应用上下文评估任何 Spring Bean。自动完成可以帮助我们直接调用 Bean 的方法——无需修改代码或重启。
一旦我们知道加载了哪些 Bean，下一个常见挑战通常是弄清为何应用行为与预期不同——这通常从配置开始。
4. 找到任何属性的真实值
属性的行为并不总是如预期那样——它们的值可能依赖于活动配置文件及其顺序，或者来自外部源，如环境变量或配置服务。
Spring Debugger 会在配置文件中内联显示生效的属性值。点击该值会导航到提供此值的来源，无论是文件还是 Java 代码。
在调试会话中，我们也可以在 “Evaluate Expression” 窗口中求值属性。在这种情况下，我们不仅可以看到值，还可以看到来源，并且调试器会显示属性值是如何更新的调用栈。
对于来自环境变量、系统设置或配置服务器的情况，如果无法导航到源，IDE 也会提供清晰的来源说明。
确认配置正确后，排查的另一个常见步骤是确保应用连接的是正确的数据库。
5. 立即检查数据库连接
在运行集成测试时，并不总是明显应用连接的是哪个数据库——尤其对于像 Testcontainers 这样的工具，其端口和凭据可能经常变化。
Spring Debugger 与 Database 工具窗口集成，可以在运行时显示活动连接。我们无需猜测连接字符串或扫描日志，就可以探索连接的容器或独立数据库中的数据。
对于内存数据库，由于这些数据库只存在于应用进程内部，并且没有专门的端点，IDE 的 JDBC 驱动无法访问模式或数据；在此情况下，可以暂停应用并通过 Repository、EntityManager 或直接获取连接对象来执行 SQL 或 JPQL 查询。
即便数据库连接正确，事务处理仍可能出现问题，而这些问题更难诊断。
6. 诊断事务问题
一个常见的 Spring 错误是 LazyInitializationException，它发生在我们在事务活动之外访问 JPA 实体时。
在调试时，Spring Debugger 会显示活动事务及其元数据——是否活动、传播类型以及事务开始的位置。
对于 JPA，它还会显示一级缓存（L1 cache）及已加载的实体，并在我们单步执行代码时实时更新。有了这些信息，我们可以清晰地看到事务边界并发现违规情况。
如果事务处于活动状态，但数据仍未正确持久化或加载，我们可以检查实体状态。
7. 检查 JPA 实体状态
在 JPA 中，实体状态至关重要。实体是 managed（已托管） 、detached（已脱管） 还是 removed（已删除） 会影响级联、刷新操作和持久化上下文行为。
Spring Debugger 会在调试器中直接显示实体生命周期状态。在任何断点处，我们都可以确认实体是否附属于当前会话。
这种信息有助于在服务层调试与持久化相关的问题，尤其是在实体在服务之间传递时。
通过结合这些功能——Bean 检查、属性追踪、数据库连接检查、事务元数据和实体状态——我们可以全面了解应用在运行时的实际行为。
8. 结论
在本文中，我们了解了调试 Spring Boot 常常意味着要回答关于配置、装配、事务和持久化的问题。
Spring Debugger 插件将这些答案直接呈现在调试器和编辑器中：
- 🔹 立即查看已加载的 Bean 及其状态
- 🔹 从应用上下文调用任何 Bean
- 🔹 跟踪任何属性值的真实来源
- 🔹 无需猜测即可查看活动数据库连接
- 🔹 一目了然地检查事务和实体状态
Spring Debugger 作为一个独立插件提供，目前尚未与 IntelliJ IDEA 捆绑发布。这样做是为了让插件开发者不依赖于 IDEA 的发布周期，并能根据需要更新插件。
有了 Spring Debugger，运行时洞察成为常规调试流程的一部分。我们不再需要在日志、配置和数据库工具之间切换来理解发生了什么。一切必要的信息——从 Bean 状态到事务细节——都在 IDE 里，帮助我们更快地解决问题。
