异常栈定位
与影响面三问
看到一段红色报错时,按本页顺序走。上半页回答「哪儿炸的」,下半页回答「要不要紧」。 配套课程:Lesson 0006。
一、栈的读法:三行定位
com.hdcloud 开头的行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),只能按下表自己推。
a.foo(b) —— 栈顶在 foo 内部foo 已被成功调用,所以 a 一定不是 nullb,或 foo 内部用到的某个字段a.foo(b) —— 栈顶就在调用这一行a 本身为 nullArrayList.addAll(Javadoc)
null 最常见的三个来源
- 方法用
return null;表示「查不到」——调用方按「一定有集合」来用就炸。Effective Java 的建议是:返回空集合,不要返回 null。 - 三方接口回了空数据——解析后字段为 null,代码没判空就往下传。
BeanUtil.copyProperties没拷到字段——目标对象上有、源对象上没有的字段会静默为 null(见项目 CLAUDE.md 惯例第 5 条)。
三、影响面三问(顺序不能换)
外面有没有捕获?
报错那一行是否包在 try { } catch 里。被捕获=流程继续;未捕获=链路当场中断。这一问决定性质。
丢掉了哪一段?
catch 在循环里面=只丢这一轮;在循环外面=整批全丢。看日志里后续的数量能验证。
与我关心的链路相关吗?
在你关心的包里搜报错类名。搜不到=两条链路无调用关系,最多通过数据库间接相关。
三种典型判定
try-catch 的机制依据:Oracle Java Tutorial · Catching and Handling Exceptions。
四、写给研发的提问模板
走完三问后,用这个格式提问,能省掉一轮来回:
来源是 <上游方法> 返回了 null。
这一行在 try 块里/不在 try 块里,所以我判断影响面是 <结论>。
请确认:一、这个判断对吗?二、<受影响的数据> 需要补吗?
先给结论再求确认,而不是只丢一张截图问「这是什么」——前者是判断,后者是转发。