spring boot 的全局异常处理机制无法捕获 outofmemoryerror,因为该异常继承自 error 而非 exception,默认情况下 @controlleradvice 和 @exceptionhandler 仅拦截 exception 及其子类。要处理内存溢出,必须在应用启动阶段通过 thread.setdefaultuncaughtexceptionhandler 设置全局未捕获异常处理器,或者在 jvm 启动参数中配置 -xx:+onoutofmemoryerror 来触发外部脚本或命令。

为什么 @ControllerAdvice 抓不到 OOM?
因为 Spring MVC 的异常分发逻辑基于 HandlerExceptionResolver,它只处理 Throwable 中的 Exception 分支。当堆内存耗尽时,JVM 会抛出 java.lang.OutOfMemoryError,这属于致命错误,通常会导致当前线程立即终止,且不会进入 Spring 的常规请求处理生命周期。因此,任何试图在 Controller 层或 Advice 层拦截 OOM 的代码都是无效的。

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
// 设置全局未捕获异常处理器
Thread.setDefaultUncaughtExceptionHandler((t, e) -> {
if (e instanceof java.lang.OutOfMemoryError) {
System.err.println("Caught OOM in thread: " + t.getName());
e.printStackTrace();
// 这里可以执行清理逻辑或发送告警
}
});
SpringApplication.run(Application.class, args);
}
}
上述代码展示了如何在应用启动时注册一个默认的未捕获异常处理器。当任何线程发生 OutOfMemoryError 时,该处理器会被调用。注意,由于 OOM 发生时系统资源极度紧张,处理器内的逻辑应尽量简单,避免再次引发 OOM。
JVM 级别的 OnOutOfMemoryError 策略
除了代码层面的捕获,更推荐的方式是利用 JVM 提供的 -XX:+OnOutOfMemoryError 选项。这个选项允许你在发生 OOM 时执行指定的 shell 命令或脚本。这种方式不依赖于 Java 代码的运行状态,即使 JVM 内部状态混乱,操作系统也能接收到信号并执行预定义的清理或转储操作。

# 启动命令示例
java -Xms512m -Xmx512m \
-XX:+OnOutOfMemoryError="/usr/local/bin/oom_handler.sh %p" \
-jar app.jar
在这个示例中,%p 会被替换为发生 OOM 的进程 ID。脚本 oom_handler.sh 可以负责生成线程 dump、堆转储文件,或者向监控系统发送告警通知。这种方法比 Java 代码层面的处理更可靠,因为它是在 JVM 层面触发的,不受 Java 运行时环境稳定性的影响。
如何验证 OOM 被正确触发?
为了验证上述两种机制是否生效,可以编写一个简单的测试程序,强制分配大量内存以触发 OutOfMemoryError。通过观察控制台输出或外部脚本的执行日志,可以确认异常处理逻辑是否按预期工作。
import java.util.ArrayList;
import java.util.List;
public class OomTest {
public static void main(String[] args) {
List<byte[]> list = new ArrayList<>();
try {
while (true) {
// 每次分配 10MB,直到内存耗尽
list.add(new byte[10 * 1024 * 1024]);
}
} catch (OutOfMemoryError e) {
System.out.println("OOM caught in main method");
}
}
}
如果使用了 Thread.setDefaultUncaughtExceptionHandler,则需要在非主线程中触发 OOM,因为主线程的异常会被 try-catch 捕获,不会触发未捕获异常处理器。如果使用 -XX:+OnOutOfMemoryError,则无论在哪里触发 OOM,都会执行指定的脚本。通过对比这两种方式的行为,可以更清晰地理解它们的应用场景和局限性。


















