Java / 系统课时

常见异常排查与调试技巧

常见异常排查与调试技巧

Java 程序出现异常时,先保留完整堆栈和触发输入,再根据异常类型、代码行号和变量状态定位根因。本课通过一个数组越界案例,演示如何复现错误、阅读调用栈、使用断点验证问题并修复边界条件,最终建立可重复执行的排查方法。

学习目标

  • 根据异常类型、消息和调用栈定位出错代码及调用来源。
  • 使用日志、断点和最小复现验证异常产生的条件。
  • 修复常见边界错误,并通过正常与异常输入验证结果。

从异常信息定位代码

Java 异常信息通常由异常类型、描述消息和调用栈组成。排查时不要只看第一行,也不要直接认定堆栈顶部就是根因。

例如,下面是一段数组越界异常的典型输出,行号取决于实际代码布局:

text
Exception in thread "main" java.lang.IndexOutOfBoundsException: Index 3 out of bounds for length 2
    at java.base/jdk.internal.util.Preconditions.outOfBounds(...)
    at java.base/jdk.internal.util.Preconditions.outOfBoundsCheckIndex(...)
    at java.base/jdk.internal.util.Preconditions.checkIndex(...)
    at java.base/java.util.Objects.checkIndex(...)
    at java.base/java.util.ImmutableCollections$ListN.get(...)
    at Main.printUser(Main.java:<LINE>)
    at Main.main(Main.java:<LINE>)

第一行的 IndexOutOfBoundsException 表示下标越界;Index 3 out of bounds for length 2 说明程序尝试访问长度为 2 的列表中的索引 3。合法索引只有 0 和 1。

调用栈由上向下记录异常抛出位置及调用来源。示例中的 Main.printUser 是首先需要检查的项目方法,Main.main 则说明它从哪里被调用。<LINE> 代表实际行号;不同 JDK 版本的内部调用帧可能不同。

常见异常可以先按以下线索检查:

异常类型 优先检查
NullPointerException 哪个引用为 null,对象在哪里创建或赋值
IndexOutOfBoundsException 下标是否小于 0 或大于等于集合长度
NumberFormatException 输入是否为空、包含非数字字符或超出目标数值范围
ClassCastException 运行时对象类型是否与目标转换类型兼容
IllegalArgumentException 传入参数是否违反方法约定

异常抛出行是定位入口,不一定是根因所在。例如空指针发生在读取用户名称时,真正的问题可能是上游查询返回了 null。

用完整示例复现并修复越界

下面先故意触发异常,再使用边界检查修复。将代码保存为 Main.java,使用 JDK 9 或更高版本编译运行。

java
import java.util.List;

public class Main {
    public static void main(String[] args) {
        List<String> users = List.of("Alice", "Bob");
        printUser(users, 1);
        printUser(users, 3);
    }

    static void printUser(List<String> users, int index) {
        System.out.println("准备读取:index=" + index + ",size=" + users.size());
        if (index < 0 || index >= users.size()) {
            System.out.println("跳过非法下标:" + index);
            return;
        }
        System.out.println("用户:" + users.get(index));
    }
}

主示例保留了两种输入:索引 1 是有效值,索引 3 超出范围。index < 0 || index >= users.size() 同时检查负数下标和上界;检查必须发生在 users.get(index) 之前。

为了观察原始错误,可以暂时注释掉 printUser 中整个 if 边界检查代码块及其内部语句,再执行程序。此时第二次调用将抛出 IndexOutOfBoundsException,堆栈中的 Main.printUser 会指向 users.get(index) 所在行。完成观察后立即恢复检查代码。

使用终端进入 Main.java 所在目录,执行:

bash
javac Main.java
java Main

恢复边界检查后的预期输出:

text
准备读取:index=1,size=2
用户:Bob
准备读取:index=3,size=2
跳过非法下标:3

第一条读取成功,第二条被明确拒绝,程序正常结束。还应额外验证索引 -1 和 0:前者应该被跳过,后者应该输出 Alice。

用断点观察变量与调用过程

日志可以记录已经发生的状态,调试器则能在执行过程中暂停程序,直接查看变量和调用关系。以 IntelliJ IDEA 为例,可以这样操作:

  1. 打开 Main.java,在 printUser 方法的 if 判断行左侧行号区域单击,设置断点。
  2. 右键单击 Main.java,选择 Debug 'Main.main()' 启动调试。
  3. 程序第一次暂停时,检查 Variables 面板中的 index=1 和 users.size()=2。
  4. 点击 Resume Program 继续执行。第二次暂停时观察 index=3,确认越界条件成立。
  5. 使用 Step Over 执行当前判断,观察程序进入非法下标分支,而不是调用 users.get(index)。

如果异常只在特定输入下出现,可以右键单击断点并设置 Condition 为 index >= users.size()。这样第一次调用不会暂停,第二次调用才会触发断点。

Java 调试器中条件断点与变量检查位置

Step Into 用于进入方法内部,Step Over 用于执行当前语句但不逐行进入被调用方法。Call Stack 或 Frames 面板可以切换不同调用帧,检查参数是如何从上层方法传入的。

调试循环时,条件断点比每轮暂停更高效。对于大量循环或并发程序,也要注意断点暂停可能改变线程调度和问题出现的时机。

按证据缩小问题范围

遇到无法立即解释的异常,可按固定顺序排查,避免一次修改多个位置后无法判断哪个改动真正起作用。

  1. 保存证据:记录完整异常堆栈、触发操作、关键输入以及运行环境。日志保留必要业务标识,但不要记录密码、令牌等敏感数据。
  2. 稳定复现:使用相同输入重复运行,确认异常是否持续出现;如果只偶尔发生,记录线程、请求和执行时序。
  3. 定位首个相关项目调用帧:根据文件名和行号找到出错语句,再向上追踪参数或对象来源。
  4. 缩减案例:移除无关业务代码,保留必需的输入、调用过程和失败条件,得到能稳定复现的最小程序。
  5. 验证单个假设:例如怀疑索引上界检查缺失,就观察 index 和 users.size(),验证前不要同时更改数据结构及调用顺序。
  6. 修复并回归:重新运行原始输入、正常输入与边界输入,确认异常消失且原有功能正常。

如果异常堆栈包含 Caused by:,还应沿异常原因链检查底层异常,不能只根据最外层包装异常判断根因。

避免掩盖异常的修复方式

以下做法容易让程序表面继续执行,却留下错误数据或丢失定位线索。

  • 只看异常消息:忽略调用栈,无法确定实际失败的代码路径。应同时查看异常行和调用来源。
  • 未复现就同时修改多处:不能证明哪项改动修复问题。应先固定输入,再逐个验证假设。
  • 捕获所有异常后直接忽略:例如使用空的 catch (Exception e),可能让程序在错误状态下继续运行。只处理明确可恢复的异常;其余异常保留上下文并向上抛出或交由统一错误处理机制记录。
  • 只测试成功路径:边界缺陷容易在后续改动中再次出现。修复后至少覆盖有效下标、负数下标和等于集合长度的下标。

动手验证排查方法

完成以下两个练习,重点是提供可复现的证据,而不只是让异常消失。

  1. 排查空指针:编写 main、loadUser、printUserName 三层方法调用,让 loadUser 在某个输入下返回 null。保存异常堆栈,指出空引用的来源,修复后分别测试存在和不存在的用户。
  2. 练习条件断点和最小复现:编写循环处理 1000 个索引的程序,使用条件断点仅在索引等于列表长度时暂停。然后将越界问题缩减成不超过 30 行的可运行程序,分别展示修复前的异常和修复后的输出。

完成排查后,应能明确回答三个问题:哪个输入触发了异常、哪一行代码违反了什么约束,以及哪些测试证明问题已经修复。保留这些证据比单纯确认程序不再报错更有价值。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

常见异常排查与调试技巧

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通