Java容器需通过信号转发或Shell脚本trap捕获SIGTERM来触发jstack导出线程堆栈，因JVM默认不响应SIGTERM做诊断；关键要求是Java进程为PID 1、jstack可用且权限匹配。
java容器中无法直接响应 docker 的 stop 信号（即 sigterm）来执行堆栈导出，因为 jvm 默认不处理该信号用于诊断操作。但可以通过信号转发 + java 信号钩子（signal.handle）或更可靠的方式——监听 sigterm 并触发 jstack ——实现全量线程堆栈导出。
原理：Docker STOP 触发的是 SIGTERM，不是 SIGQUIT
Docker 执行 docker stop 时，默认向 PID 1 进程发送 SIGTERM（信号编号 15），等待一段时间后若未退出再发 SIGKILL。而 jstack -l 等诊断命令需主动调用，JVM 本身对 SIGTERM 仅做优雅关闭（如触发 shutdown hook），不会自动打印堆栈。
关键点：
- 容器内必须让 Java 进程是 PID 1（否则信号收不到）；
- 需显式捕获 SIGTERM，并在其中调用 jstack 或触发 JVM 内部 dump（如通过 ManagementFactory）；
- jstack 必须能 attach 到目标 JVM（要求同一用户、启用 -XX:+DisableAttachMechanism 会阻断）。
推荐方案：Shell 入口脚本 + trap 捕获 SIGTERM
不依赖 Java 层信号处理，更稳定。适用于 OpenJDK 基础镜像（含 jstack）：
- 编写启动脚本（如
entrypoint.sh），使用exec java ... &启动 Java，并记录 PID - 用
trap捕获TERM，在退出前运行jstack -l $JAVA_PID > /tmp/threaddump-$(date +%s).txt - 最后用
kill -TERM $JAVA_PID让 Java 正常退出 - Dockerfile 中设置
CMD ["./entrypoint.sh"]，确保脚本是 PID 1
示例片段：
#!/bin/sh java -jar app.jar & JAVA_PID=$! trap "jstack -l $JAVA_PID > /tmp/threaddump-$(date -u +%Y%m%d-%H%M%S).txt 2>&1; kill -TERM $JAVA_PID; wait $JAVA_PID" TERM wait $JAVA_PID
Java 层方案：Signal.handle + Runtime.addShutdownHook（辅助增强）
适用于不能改入口脚本的场景，但有局限性：
- 用
Signal.handle(new Signal("TERM"), handler)注册处理器（需sun.misc.Signal，JDK 8/11 可用，JDK 17+ 需加--add-opens） - 在 handler 中调用
Thread.getAllStackTraces()或ManagementFactory.getThreadMXBean().dumpAllThreads(true, true)输出到文件 - 配合
Runtime.getRuntime().addShutdownHook(...)作为兜底（应对 SIGKILL 以外的退出） - 注意：该方式无法获取 native stack、JNI 状态等完整信息，不如
jstack -l
注意事项与验证方法
必须确认：
- 容器内 jstack 与 JVM 版本一致（否则 attach 失败）；
- Java 进程以非 root 用户运行时，jstack 需同用户执行（避免权限拒绝）；
- 若用 Alpine 镜像，需改用 openjdk:jre-alpine 并手动安装 openjdk11-jdk 或切换至 eclipse-temurin 等含 jstack 的镜像；
- 验证方式：容器运行中执行 docker kill -s TERM ，然后 docker cp 查看 /tmp 下是否生成 threaddump 文件。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
