绵羊料理1. 项目概述
1.1 调试这件事，真的值得认真对待
做 Spring Boot 开发的人，大概率都有过这样的经历：代码写完了，启动也没报错，但接口返回的数据就是不对。或者更恼火的是——本地跑得好好的，一部署到服务器就出问题。这时候如果只会 System.out.println 到处打日志，排查效率会非常低。
调试（Debug）不是“代码写不出来才用”的东西，它是日常开发里最常用的技能之一。IDEA 和 Eclipse 作为 Java 开发者最常用的两个 IDE，内置的调试功能其实非常强大，但很多人只用到了最基础的断点、单步执行，很多高价值的功能一直没被发现。
这篇内容我会结合自己的实际使用经验，把 Spring Boot 项目在 IDEA 和 Eclipse 里的调试技巧从头到尾梳理一遍。从环境准备到断点进阶，从日志定位到远程调试，争取做到“拿来就能用、照着就能做”。适合刚入行的新手，也适合用 IDE 用了好几年但没深挖过调试功能的同学。
1.2 调试的本质是什么
调试的核心本质是三件事：让程序在指定的位置停下来、看清当前的状态、控制程序按你需要的方式继续走。
我见过不少同学调试就是“打个断点，然后一直点 Resume（F9）”，跑到哪算哪，看不明白就把断点删了换地方。这样也不是不行，但效率太低。如果你能把断点的触发条件、变量的求值、调用栈的分析、线程状态的观察都掌握了，调试就从“碰运气”变成了一种有章可循的系统性工作。
还有一个很多人忽略的点：调试工具只是辅助，真正的核心是思路。比如一个接口返回数据不对，你得先判断是 Controller 层的问题、Service 层的问题还是 Mapper 层的问题，然后决定在哪里打断点、断点打几处、分别看什么变量。脑子里有排查路径，手上的工具才有意义。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 调试前的环境准备：IDEA 与 Eclipse 的配置细节
2.1 IDEA 中调试 Spring Boot 项目的前置配置
IDEA 开箱即用的调试功能已经很完善了，但还是有几个配置值得你提前确认，否则调试过程中会遇到各种小麻烦。
第一，确认编译信息。 调试时断点能不能命中，跟编译输出的 class 文件是否包含调试信息有关。在 File > Settings > Build, Execution, Deployment > Compiler > Java Compiler 里，Generate debugging info 这个选项必须勾上。默认是开启的，但如果之前有人改过配置，断点就可能出现“打上但没反应”的情况。
第二，配置热部署。 Spring Boot 项目调试时，改代码后的重启很耽误时间。建议引入 spring-boot-devtools 依赖，它可以实现类变更后的自动重启，而且只重启应用上下文，速度比手动重启快很多。
xml复制<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-devtools</artifactId>
<optional>true</optional>
</dependency>
注意 optional 要设为 true，这样部署到生产环境时不会把 devtools 打进去。另外，IDEA 里要开启 Build project automatically，并且在高级设置里勾选 Allow auto-make to start even if developed application is currently running，否则改了代码不会自动编译，devtools 也感知不到变化。
第三，设置日志输出。 调试时经常需要看 SQL、看参数，Spring Boot 默认的日志级别可能不够细。我一般会在 application.yml 里单独给 MyBatis 或 JPA 的 Mapper 包设置 DEBUG 级别：
yaml复制logging:
level:
com.example.demo.mapper: debug
org.springframework.jdbc.core: debug
这样既能看清楚 SQL 语句和参数，又不会被框架的无关日志刷屏。
2.2 Eclipse 中调试 Spring Boot 项目的前置配置
Eclipse 在国内的使用人群虽然不如 IDEA 多，但很多老项目和教学场景仍然在用。Eclipse 调试 Spring Boot 项目，建议用 Spring Tools 4（STS4）插件，或者直接装 Spring Tools Suite 这个集成版 IDE。
Eclipse 里调试前需要确认两个设置：
第一，编译器兼容级别。 在 Window > Preferences > Java > Compiler 里，Compiler compliance level 要和你项目用的 JDK 版本匹配。比如 JDK 8 的项目就选 1.8，如果这里配置错误，启动 Spring Boot 时可能出现 UnsupportedClassVersionError。
第二，调试信息的生成。 在同一个页面往下看，Classfile Generation 相关的选项默认都是开启的，确认 Add variable attributes 和 Add line number attributes 被勾选。否则调试时你看不到变量值，断点处的行号也可能错乱。
Eclipse 启动 Spring Boot 项目的方式很简单：在启动类上右键，选择 Run As > Spring Boot App 或者 Debug As > Spring Boot App。需要注意，如果项目中配置了 Maven 多模块，Eclipse 的 classpath 没有正确识别，可能会找不到启动类的依赖，这时候需要在项目上右键 Maven > Update Project。
2.3 环境配置的核心心得：先跑起来，再谈调试
我自己的经验是，能调试成功的前提永远是“能启动成功”。很多人的断点不生效、调试崩溃，根源不是调试技巧的问题，而是项目本身启动就有隐患。比如 Maven 依赖冲突、JDK 版本不对、端口被占用，这些都会干扰调试过程。
遇到启动问题，先看控制台报错，不要急着去 IDE 设置里翻来翻去。Spring Boot 的报错信息其实写得很清楚，比如端口被占用会直接告诉你 Port 8080 was already in use。用 lsof -i:8080（Mac/Linux）或者 netstat -ano | findstr 8080（Windows）找到占用进程，结束掉就行。这类基础问题解决干净了，调试才会顺畅。
3. IDEA 调试实战：从基础断点到高级技巧
3.1 断点的种类与使用场景
IDEA 的断点看似简单，其实分好几种，不同场景用不同断点，效率差别很大。
行断点是最常用的，点击代码行号右侧空白处即可。但行断点有个缺点是：如果这行代码在一个频繁调用的循环里，断点会命中无数次，你需要不停地按 Resume，很浪费时间。
方法断点：在方法声明行打断点，进入方法时和退出方法时都会暂停。适合排查“这个方法到底被谁调用了”“返回值是什么”这类问题。但方法断点会显著降低程序执行速度，Spring Boot 启动时不要在框架方法上打方法断点，否则启动过程会慢得让你怀疑人生。
字段断点：在字段声明行打断点，字段被读取或修改时触发。这个功能非常实用。比如有个全局变量，你不知道哪段代码改了它的值，在字段上打断点，勾选 Field access 和 Field modification，就能精准定位到修改的代码位置。
条件断点：右键断点，可以输入一个布尔表达式。比如循环到第 100 次的时候才想停下来，条件写成 i == 100 即可。条件断点解决的是“断点命中太频繁”的问题，但要注意，条件表达式不要写得太复杂，否则会影响性能。
异常断点：在 Run > View Breakpoints 里可以添加异常断点，比如 NullPointerException。一旦代码抛出这个异常，程序会在异常抛出的位置停下来，哪怕你没有在那个位置打任何断点。排查空指针问题时，这个功能比人肉找代码效率高太多了。
3.2 Frames 与 Variables：理清调用栈和变量关系
断点命中后，IDEA 的调试窗口会显示几个关键面板。很多人只看 Variables 面板，忽略了 Frames 面板，这是个常见错误。
Frames（调用栈）面板告诉你当前断点所在的调用链。比如 Controller 调 Service，Service 调 Mapper，断点打在 Mapper 里，Frames 从上到下就是 Mapper -> Service 实现类 -> Controller -> Spring 框架的调用入口。点击任意一层，右侧 Variables 面板会立刻切换成那一层的局部变量和参数。这意味着你不需要在每一层都打断点，只看调用栈就能回溯整个调用链的数据。
Variables 面板里的变量很多，但真正值的关注的是 this 引用的内容——比如 this 指向的是哪个 Mapper 实现类，里面注入的是什么数据源，这能帮你快速确认 Spring 容器里到底装配了哪个 Bean。
还有一个很实用的操作：在 Variables 面板里右键变量，选择 Copy Value 或 Copy Name。排查问题时经常要把变量值跟接口文档、数据库记录做比对，复制出来省去手打的时间。
3.3 Evaluate Expression：调试时直接执行代码
IDEA 的 `Evaluate