1. 概述
Java异常能帮我们定位和修复bug，但当异常消息是null时，就像在黑暗中摸索，完全找不到线索。本文将深入探讨这个令人头疼的问题，并提供实用的解决方案。
2. 问题引入
先通过一个典型场景理解问题：
class Team {
private String name;
//... getters and setters
}
class Player {
private static Logger LOG = LoggerFactory.getLogger(Player.class);
private String name;
private Team team;
public Player(String name) {
this.name = name;
}
void output() {
try {
if (team != null) {
LOG.info("Player:{}, Team:{}", name.toUpperCase(), team.getName().toUpperCase());
} else {
throw new IllegalArgumentException("Team is null");
}
} catch (Exception e) {
LOG.error("Error occurred:" + e.getMessage());
}
}
//... getters and setters
}
这段代码中，Player类引用了Team实例。在output()方法里，当team为null时会抛出带明确消息的异常，整个方法体被try-catch块包裹。
现在创建实例并调用：
Player kai = new Player("Kai");
kai.setTeam(new Team());
kai.output();
如果在JDK 14之前的版本运行，会得到这样的输出：
10:03:54.016 [main] ERROR com.baeldung...Player -- Error occurred: null
⚠️ null异常消息完全没用，根本看不出哪里出了问题！接下来我们分析原因并解决这个坑。
3. 空异常消息的真相
当Java异常消息显示null时，通常表示异常被抛出时没有附加消息。比如在JDK 14之前，NullPointerException就没有消息。
仔细看代码：kai确实有非空的Team引用，但Team.name属性未设置，导致team.getName()返回null。因此team.getName().toUpperCase()实际抛出了意外的NullPointerException。
JDK 14之前，NullPointerException没有消息，所以输出显示null。
JEP 358在JDK 14实现后，**NullPointerException开始包含详细消息**。用JDK 17运行相同代码会得到：
10:23:53.016 [main] ERROR com.baeldung...Player -- Oops! Error occurred.Cannot invoke "String.toUpperCase()" because the return value of "com.baeldung...Team.getName()" is null
这次消息直接指出了NullPointerException的根源，帮我们快速定位问题。但实际开发中，我们可能必须使用旧版JDK，所以需要其他方案。
4. 用堆栈跟踪替代消息
遇到异常时，堆栈跟踪是定位问题的起点。输出异常时应该包含完整堆栈跟踪，而不是只打印消息。
4.1 使用printStackTrace()
最直接的方式是调用Exception.printStackTrace()：
void outputWithStackTrace() {
try {
// ... 相同代码
} catch (Exception e) {
e.printStackTrace();
}
}
将catch块中的LOG.error()替换为e.printStackTrace()。现在调用kai.outputWithStackTrace()会得到：
java.lang.NullPointerException
at com.baeldung...Player.outputWithStackTrace(ExceptionGetMessageNullUnitTest.java:48)
...
即使没有消息，堆栈跟踪也清晰显示了异常类型和发生位置，给了我们明确的排查起点。
4.2 使用日志框架记录异常
实际项目中通常用日志框架管理错误（如SLF4J）。推荐用日志框架记录完整异常：
void outputWithStackTraceLog() {
try {
// ... 相同代码
} catch (Exception e) {
LOG.error("Error occurred.", e);
}
}
调用kai.outputWithStackTraceLog()后，日志输出：
10:36:31.961 [main] ERROR com.baeldung...Player -- Error occurred.
java.lang.NullPointerException
at com.baeldung...Player.outputWithStackTraceLog(ExceptionGetMessageNullUnitTest.java:60)
...
这种日志格式既包含自定义消息，又有完整堆栈跟踪，能快速定位到"Team.name为null"的根本问题。
5. 总结
本文分析了Java中空异常消息的成因（主要是旧版JDK的NullPointerException无消息），并提供了两种实用解决方案：
✅ **使用printStackTrace()**：简单粗暴，适合快速调试
✅ 用日志框架记录异常：生产环境推荐，能同时记录自定义消息和堆栈跟踪
记住：当异常消息为null时，堆栈跟踪才是真正的救命稻草。下次再遇到这种情况，别再对着null发呆了，直接看堆栈吧！