异常堆栈第一行是异常类型，真正定位需看首个at行的文件名和行号；native method或unknown source应向上回溯至最近自定义代码行；java 14+启用showcodedetails可精准指出null变量。
看堆栈最上面那行，不是第一行
Java 报 java.lang.NullPointerException 时，异常信息里带的行号通常不是你“写错 null 的那一行”，而是它真正触发空指针的地方——比如调用 toString()、length()、.getXXX() 或进入方法体时。堆栈里最上面（即第一个）at 行才是关键。
常见误判：看到堆栈第一行是 Exception in thread "main" java.lang.NullPointerException 就以为没行号；其实要往下找第一个 at com.xxx.YourClass.methodName(YourClass.java:42) 这样的行。
- 如果用了 Lombok 的
@Data或@ToString，空指针可能发生在自动生成的toString()里，行号指向的是 Lombok 注入的合成方法，实际问题在字段初始化位置 - IDE（如 IntelliJ）点击堆栈行号能直接跳转，但注意：跳过去看到的可能是字节码反编译结果（尤其用了 Lambda 或 Stream），此时需回退到原始源码确认上下文
- 如果行号显示为
Unknown Source，说明 class 没带调试信息（-g编译参数缺失或 jar 包未附带sources.jar），得查构建配置或换带 debug info 的依赖版本
System.out.println() 不是万能定位法
盲目在疑似变量前加 System.out.println(obj) 可能掩盖真实问题——比如 obj 本身不为 null，但它的某个字段为 null，而你只打印了 obj，结果看到 “not null” 就排除了它，实际崩溃点在 obj.getName().trim()。
Java Linux版下载入口，提供 Oracle JDK 26.0.2 官方 Linux 安装包、Java 环境配置、JDBC 数据库连接和 Java 服务端开发相关信息。
- 优先用 IDE 调试器打断点，停在异常抛出前一行，鼠标悬停看各变量值，尤其是链式调用中的每一环：
a.b.c.d()要分别检查a、b、c是否为 null - 如果不能调试（如生产环境），改用
Objects.requireNonNull(obj, "obj must not be null")主动抛出带提示的异常，比静默 NPE 更易追溯 - 避免在日志里只打
log.info("obj = {}", obj)—— 这种占位符不会触发toString()，看不出是否真会 NPE；应显式判断：if (obj == null) log.warn("obj is null at step X")
Stream 和 Optional 容易藏匿 NPE 行号
用 stream().map(x -> x.getName()).collect() 时，如果某个 x 是 null，NPE 抛出位置是 ReferencePipeline.java 内部，行号完全脱离你的源码。同理，Optional.of(null) 立刻炸，但 Optional.ofNullable(x).get() 在 get() 才炸，行号指向你写的 .get() 那行，而非 x 初始化处。
-
stream().filter(Objects::nonNull).map(...)是安全写法，但要注意 filter 只管流中元素，不管 map 内部逻辑 - 别迷信
Optional能防 NPE：它自己可被设为 null，opt.map(...).orElse(...)中若opt是 null，调用map就直接 NPE - Lambda 表达式内联后，编译器可能把多行合并成一行，导致报错行号对应整段 lambda，需结合上下文和变量名推断具体哪一环为空
混淆包名或 ProGuard 后行号失效怎么办
Android 或混淆后的 Java 应用里，堆栈显示 at a.a.b.c(Unknown Source)，这时行号已不可信。必须依赖 mapping 文件还原。
- 确保打包时生成并保留
mapping.txt（ProGuard/R8 默认开启），线上 crash 日志收集系统（如 Firebase Crashlytics）应支持自动上传 mapping - 本地可用
retrace.sh -verbose mapping.txt obfuscated_trace.txt还原（Windows 用retrace.bat），注意路径分隔符和编码 - 如果连类名都混淆了（如
a、b），光靠行号没用，得结合 crash 前后日志里的关键状态（如用户操作、网络返回、SharedPreference key）交叉定位
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
