真正出问题的代码在堆栈最顶部第一个at行,如UserService.java:42;需优先检查该行及附近逻辑,若为框架包则向下查找首个本项目包名对应行。

直接看堆栈最顶那一行的类名、方法名和行号,就是异常发生的原始位置。
堆栈信息里哪一行才是关键
Java异常堆栈是从下往上执行、从上往下抛出的。真正出问题的代码,一定在堆栈最顶部(也就是第一个 at 行)。
- 格式通常是:
at com.example.service.UserService.getUserById(UserService.java:42) - com.example.service.UserService 是类全名
- getUserById 是报错的方法名
- UserService.java:42 是源码文件名和具体行号
- 如果这一行是框架内部调用(比如
org.springframework...),就继续往下看第一个你项目里的包路径
日志中没显示行号?先检查配置
行号缺失往往不是日志本身的问题,而是编译或运行时配置导致的。
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式,或要求按照代码注释规范处理 Java 文件时,使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则,并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括:补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- 确认 class 文件编译时保留了调试信息:Maven 中
<debug>true</debug>必须开启 - 避免使用
e.printStackTrace()直接输出——它依赖标准输出,线上环境不可靠;改用 SLF4J 的logger.error("msg", e),自动带完整堆栈 - Logback 或 Log4j2 配置中,
%ex或%throwable要显式启用,否则堆栈会被截断
遇到嵌套异常,怎么找“真凶”
Spring、MyBatis 等框架常把原始异常包装成新异常,形成多层 Caused by。
立即学习“Java免费学习笔记(深入)”;
- 优先找最后一层
Caused by,而不是最上面的Exception - 逐级向下读,直到出现你项目中的包名(如
com.yourcompany...) - 常见模式:
SQLTimeoutException→CannotCreateTransactionException→SQLException→ 最终NullPointerException在你自己代码第 73 行
线上环境看不到源码?用符号映射快速还原
生产环境常部署 jar 包,没有 .java 文件,但依然能定位。
- 确保构建时生成并保留
sources.jar和javadoc.jar - 用
jstack -l <pid>获取线程堆栈时,配合javap -c反编译对应 class,对照行号反推逻辑位置 - IDEA 或 Eclipse 支持 attach 到远程 JVM,并自动关联本地 source,点击堆栈行即可跳转

















