IntelliJ IDEA 怎么设置只在指定条件下触发的断点

调试循环或接口请求时，普通断点往往会被无关数据反复打断。IntelliJ IDEA 可以把它改成条件断点：在代码行或断点标记上右键，选择 Add Conditional Breakpoint，然后填入一个在当前行可计算的布尔表达式。表达式为 true 时暂停，结果为 false 时忽略这次命中。

步骤一：先在可执行代码行放置普通断点

打开需要排查的方法，先找到真正会执行的代码行，例如方法调用、赋值或条件分支内部的语句。点击代码左侧的 gutter 会放置行断点；也可以把光标放在该行按 Ctrl+F8。不要把断点放在空行、注释或只有声明但没有可执行指令的位置，否则启动调试后可能显示为无效状态。

这一阶段只需要确认左侧出现红色圆点。先不要急着输入条件，保留普通断点有助于判断问题究竟是“代码没有走到这里”，还是“条件表达式写错”。

步骤二：从断点菜单进入条件设置

右键代码行或已经出现的断点标记，在菜单中选择 Add Conditional Breakpoint。如果当前已经是普通断点，也可以右键后选择 Edit Breakpoint，需要完整属性时再进入 More 或使用 Run | View Breakpoints（Ctrl+Shift+F8）。

弹窗里的 Condition 是“是否暂停”的判断式；它和 Evaluate and log 不同，后者用于记录表达式结果，不会自动把每次命中都变成暂停点。设置后点击 Done 或关闭弹窗保存，具体按钮文字会随 IDEA 版本和界面布局略有变化。

步骤三：填写条件并选择暂停范围

假设当前代码行能访问 orderId 和 retryCount，可以填入：

orderId == 1008 && retryCount > 0

这表示只关注订单 1008 的重试路径。条件必须在断点所在位置有效；如果变量还没有声明、已经超出作用域，或者表达式类型不是布尔值，断点就可能变成警告或无法命中。调试器会在每次执行到该行时先计算条件，再决定是否暂停。

在多线程程序里，Suspend: All 适合需要冻结完整现场的排查；Thread 只暂停命中条件的线程，其他线程可以继续运行，更适合观察并发交互。条件表达式尽量保持无副作用，不要在里面修改业务数据或调用会改变状态的方法。

步骤四：用命中状态验证并处理不生效

用 Debug 启动当前配置，先触发一条 orderId=1007 的请求，再触发 orderId=1008 且 retryCount>0 的请求。前者应该直接通过，后者才暂停。暂停后在 Debug 窗口的 Variables 区域检查两个变量，确认停下来的确是目标数据，而不是条件表达式偶然得到真值。

如果始终不暂停，按这个顺序检查：断点是否为 Enabled、图标是否为已验证而不是 Invalid；当前是否用 Debug 而非 Run 启动；代码是否重新编译并执行到了同一行；条件中的变量是否仍在作用域内。若只是暂时不想删除条件，可在断点列表中取消 Enabled，参数会被保留。

常见问题

条件断点能写多条语句吗？

IDEA 文档允许条件体包含多条语句，但实践中建议先用简单布尔表达式。复杂计算更容易产生副作用，也更难判断究竟是哪一部分导致断点没有命中。

条件断点和日志断点有什么区别？

条件断点满足条件后会暂停程序；日志断点用于记录消息或表达式结果，可以设置为不暂停。只想观察频次和变量变化时，优先考虑日志断点。

删除和禁用断点有什么不同？

删除会丢失当前断点参数，禁用只让它暂时不生效。需要反复切换排查条件时，用 Enabled 开关更稳妥。