jattach不是JDK自带工具,但能绕过JVM安全限制获取dump;当jstack卡住或报“Unable to open socket file”时,jattach因不依赖tools.jar和libattach.so、通过ptrace或/proc直接注入,可在权限一致且Attach API启用的受限环境中成功执行dump。

jattach 不是 JDK 自带工具,不能直接替代 jstack,但能绕过 JVM 安全限制在某些场景下获取 dump —— 前提是你没禁用 Attach API,且目标 JVM 启动时未加 -XX:+DisableAttachMechanism。
为什么 jattach 有时比 jstack 更有用
当 jstack pid 卡住、无响应或报 Unable to open socket file 时,常见原因有:JVM 关闭了 Attach API、运行用户权限不一致(比如 Java 进程由 root 启动,你用普通用户执行 jstack)、或容器中 /tmp 被挂载为 noexec。jattach 是一个独立的 C 工具,它通过 Linux 的 ptrace 或 /proc/pid/fd 接口直接注入命令到 JVM,不依赖 tools.jar 或 libattach.so 的完整加载路径,因此在部分受限环境中仍可工作。
- 它不启动新 JVM,也不 fork 子进程,所以开销极低
- 支持 JDK 8–21,包括 OpenJDK 和 Oracle JDK
- 必须与目标 JVM 运行在同一用户下(或 root),否则
/proc/pid不可读 - 不能用于 Docker 默认的 PID namespace 隔离模式,除非加
--pid=host或挂载/proc
jattach 获取 thread dump 的标准流程
先确认 jattach 可执行并有权限访问目标进程:
- 下载预编译二进制:
wget https://github.com/apangin/jattach/releases/download/v1.7/jattach,然后chmod +x jattach - 查目标 PID:
jps -l或pgrep -f "java.*Application" - 执行 dump:
./jattach <code>piddump(注意不是threaddump,命令名就是dump) - 输出默认打印到 stdout,建议重定向:
./jattach <code>piddump > threaddump.log
该命令等价于触发 JVM 内部的 HotSpotDiagnosticMBean.dumpHeap() 或线程 dump 动作,但底层走的是 JVMTI 的 GetAllThreads + GetThreadInfo 流程,和 jstack 生成的内容结构一致,包含 java.lang.Thread.State、nid、锁持有关系等。
立即学习“Java免费学习笔记(深入)”;
jattach 的 dump 输出和 jstack 有啥区别
内容几乎一样,但有三个关键差异点:
-
jattach dump不支持-l(锁详情)或-m(native 栈)参数,锁信息只显示基础的waiting on,不展开java.util.concurrentownable synchronizers 列表 - 不会自动识别死锁 —— 即使存在 Java 级死锁,
jattach dump也不会像jstack -l pid那样在末尾附加 “Found one Java-level deadlock” 小节 - 不校验 JVM 是否启用了
-XX:+PrintGCDetails等诊断选项,所以即使 JVM 是最小化启动(如嵌入式场景),只要 Attach API 开着,它就能跑
如果你发现 jattach dump 输出里某个线程状态是 WAITING (parking) 但没写明等哪个锁,得配合 jstack -l pid 补充一次对比看 —— 很可能只是 jattach 没触发锁枚举逻辑。
容易忽略的权限和路径陷阱
最常卡在这三处:
-
Permission denied:不是文件权限问题,而是目标进程 UID 和当前用户 UID 不一致,ls -l /proc/<code>pid看 owner;容器中尤其常见,Java 进程 UID=1001,你 shell 登录 UID=1000 → 必须切到同用户或用 root -
No such process:PID 正确但/proc/<code>pid/fd 下没有足够句柄(jattach依赖读取/proc/pid/fd/中的 socket 或 pipe),说明 JVM 启动时加了-XX:+DisableAttachMechanism,此时 jattach 也失效 - 输出为空或只有 “Attached to VM”,没 dump 内容:JVM 是 GraalVM Native Image 或某些裁剪版(如 Alibaba Dragonwell 的 lite 版),JVMTI 支持不完整,jattach 无法调用
GetAllThreads
真正零停机的 dump 从来不是靠工具选型,而是靠提前验证:上线前用 jattach <code>pid version 测试是否可达,比出问题再试强得多。


















