Reference · 打印友好

异常栈定位
与影响面三问

看到一段红色报错时,按本页顺序走。上半页回答「哪儿炸的」,下半页回答「要不要紧」。 配套课程:Lesson 0006。

一、栈的读法:三行定位

步骤
动作
得到什么
1
看最上面那一行
真正抛异常的地方(可能在 JDK 或框架里,不是我们的代码)
2
从上往下找第一个 com.hdcloud 开头的行
我们自己的代码现场,带类名和行号——排查从这里开始
3
继续往下看剩余的 com.hdcloud 行
调用它的上游是谁,用来判断这条链路属于哪个业务

依据:Throwable.getStackTrace() 官方文档——「数组的第一个元素代表栈顶,也就是这个调用序列中最后一次方法调用」 (Oracle Java SE API)。

包名速认:java.* / javax.* = JDK 自带 · org.apache.*、org.springframework.* = 框架 · com.hdcloud.* = 网货自己的代码。只有第三种能改。

二、NPE 专项:谁是 null

NullPointerException = 对一个「什么都没指向」的变量用了点号 .。 本项目 <java.version>1.8</java.version>、构建用 JDK 11,均早于 Java 14, 拿不到「帮助性 NPE 消息」(JEP 358),只能按下表自己推。

栈顶停在哪
说明什么
null 的是谁
a.foo(b) —— 栈顶在 foo 内部
foo 已被成功调用,所以 a 一定不是 null
传进去的参数 b,或 foo 内部用到的某个字段
a.foo(b) —— 栈顶就在调用这一行
方法根本没进去,点号左边就炸了
a 本身为 null
栈顶在 ArrayList.addAll
官方文档写明:传入集合为 null 即抛 NPE
(Javadoc)
括号里那个集合是 null

null 最常见的三个来源

三、影响面三问(顺序不能换)

问题 一

外面有没有捕获?

报错那一行是否包在 try { } catch 里。被捕获=流程继续;未捕获=链路当场中断。这一问决定性质。

问题 二

丢掉了哪一段?

catch 在循环里面=只丢这一轮;在循环外面=整批全丢。看日志里后续的数量能验证。

问题 三

与我关心的链路相关吗?

在你关心的包里搜报错类名。搜不到=两条链路无调用关系,最多通过数据库间接相关。

三种典型判定

✅
被捕获 + 循环内 + 链路无关 ——不影响业务流程,最多是数据少了一部分。可以正常发版,另开单跟进。
⚠️
被捕获 + 循环外 ——流程不断,但整批数据丢失。要评估这批数据下游有谁在用,可能需要补数。
🛑
未被捕获 ——异常会一路往上抛,这一次业务操作直接失败。若在 MQ 消费或定时任务里,还要问会不会无限重试。必须先修再发。

try-catch 的机制依据:Oracle Java Tutorial · Catching and Handling Exceptions。

四、写给研发的提问模板

走完三问后,用这个格式提问,能省掉一轮来回:

我看到 <类名>:<行号> 抛了 NullPointerException,为 null 的应该是 <变量>,
来源是 <上游方法> 返回了 null。
这一行在 try 块里/不在 try 块里,所以我判断影响面是 <结论>。
请确认:一、这个判断对吗?二、<受影响的数据> 需要补吗?

先给结论再求确认,而不是只丢一张截图问「这是什么」——前者是判断,后者是转发。