如何忽略SIGTERM信号并在Kubernetes中保持Java应用线程存活

首先要明确：Java的shutdown hook是在JVM启动关闭流程后才执行的，此时JVM已经开始中断所有非守护线程并等待它们终止，这就是你看到其他线程被自动终止的原因。要在处理停机逻辑时保持业务线程存活，需要绕过JVM的默认关闭流程，自行捕获SIGTERM信号并控制停机节奏。

方法一：自定义信号处理器捕获SIGTERM #

直接注册SignalHandler来拦截SIGTERM信号，阻止JVM触发默认的关闭流程，然后在自定义逻辑中完成优雅停机：

import sun.misc.Signal;
import sun.misc.SignalHandler;

public class GracefulShutdownHandler implements SignalHandler {
    private volatile boolean shuttingDown = false;

    @Override
    public void handle(Signal signal) {
        if (shuttingDown) {
            return; // 避免重复处理信号
        }
        shuttingDown = true;

        // 1. 停止接收新请求（比如关闭端口、拒绝新的数据库连接等）
        stopAcceptingNewRequests();

        // 2. 等待现有业务线程完成当前任务
        waitForActiveThreadsToFinish();

        // 3. 清理资源（关闭数据库连接池、释放文件句柄等）
        cleanupResources();

        // 4. 主动终止JVM
        System.exit(0);
    }

    private void stopAcceptingNewRequests() {
        // 实现你的逻辑，比如关闭Servlet容器的连接器
    }

    private void waitForActiveThreadsToFinish() {
        // 比如遍历业务线程池，调用awaitTermination等待任务完成
        // executorService.awaitTermination(30, TimeUnit.SECONDS);
    }

    private void cleanupResources() {
        // 关闭数据库连接池等资源
    }

    public static void register() {
        Signal.handle(new Signal("TERM"), new GracefulShutdownHandler());
    }
}

在应用启动时注册这个处理器：

public static void main(String[] args) {
    GracefulShutdownHandler.register();
    // 初始化并启动应用
}

方法二：利用框架内置的优雅停机能力（如果使用Spring Boot等框架） #

如果你的应用是基于Spring Boot，不需要自己写信号处理器，直接配置即可：

1. 在application.properties中开启优雅停机：

server.shutdown=graceful
spring.lifecycle.timeout-per-shutdown-phase=30s

2. 确保Kubernetes的terminationGracePeriodSeconds设置大于上述超时时间（比如设为40秒），给框架足够时间处理现有请求。

关键注意事项 #

• Kubernetes配置：必须设置terminationGracePeriodSeconds，默认是30秒，如果你的优雅停机需要更长时间，要调大这个值，避免Kubernetes在优雅停机完成前发送SIGKILL强制终止容器。
• 线程处理：业务线程需要正确处理中断信号（不要忽略InterruptedException），这样在等待线程完成时，能正常响应终止请求。
• 避免重复触发：信号处理器中要加标记，防止多次收到SIGTERM时重复执行停机逻辑。

内容的提问来源于stack exchange，提问作者Agilulfe