一、前言
在本文中，我们总结下抓 Java dump 的几种不同方法。
Java Heap Dump 是特定时刻 JVM 内存中所有对象的快照。它们对于解决内存泄漏问题和分析 Java 应用程序中的内存使用情况非常有用。
Java Heap Dump 通常以二进制格式的 hprof 文件存储。我们可以使用 jhat 或 JVisualVM 之类的工具打开和分析这些文件。同样，使用 MAT 工具分析是很常见的。
二、JDK 工具包
JDK 附带了几个以不同方式 Heap Dump 的工具。所有这些工具都位于 JDK 主目录下的 bin 文件夹下。因此，只要这个目录包含在系统路径中，我们就可以直接从命令行启动它们。
1、jmap
jmap 是一种工具，用于打印有关正在运行的 JVM 中的内存的统计信息。我们可以将其用于本地或远端进程。
要使用 Jmap Heap Dump ，我们需要使用 Heap Dump 参数：
jmap -dump:[live],format=b,file=<file-path> <pid>
与该参数一起，我们应该指定几个参数：
- live：如果设置，则仅打印具有活动引用的对象，并丢弃准备好进行垃圾回收的对象。此参数是可选的。
-
format = b：指定转储文件将采用二进制格式。如果未设置，结果是相同的 - file：将写入的文件
- pid：Java 进程的 ID
举一个例子是这样的：
jmap -dump:live,format=b,file=/tmp/dump.hprof 12587
注意：我们可以使用 jps 命令轻松获取 Java 进程的pid。jmap 是作为实验工具在 JDK 中引入的。因此，在某些不支持的情况下，最好使用其他工具代替。
2、jcmd
jcmd 是一个非常完整的工具，可以通过向 JVM 发送命令请求来工作。我们必须在运行 Java 进程的同一台机器上使用它。
它的最多命令就是 GC.heap_dump，我们可以通过指定进程的 pid 和输出文件路径来使用它来 Heap Dump：
jcmd <pid> GC.heap_dump <file-path>
我们可以使用上面例子中使用的相同参数执行它：
jcmd 12587 GC.heap_dump /tmp/dump.hprof
与 jmap 一样，生成的 dump 为二进制格式。
3、JVisualVM
JVisualVM 是带有图形用户界面的工具，它使我们可以监控 Java 应用程序，对其进行故障排除和分析。GUI 简单，直观并且易于使用。
我们可以右键单击 Java 进程并选择“线程dump”选项，该工具将创建 dump 并在新选项卡中将其打开：
JVisualVM
注意：我们可以在“基本信息” 部分中找到创建的文件的路径。从 JDK 9开始，Visual VM 不包括在 Oracle JDK 和 Open JDK 发行版中。因此，如果我们使用的是 Java 9 或更高版本，则可以从 Visual VM 开源项目站点获得 JVisualVM 。地址：https://visualvm.github.io/
三、自动抓取 heap dump
上面介绍所有工具均在特定时间手动去 dump 的。在某些情况下，我们希望在发生 java.lang.OutOfMemoryError 时获取 Heap Dump ，以帮助我们分析问题。
对于这种情况，Java 提供了 HeapDumpOnOutOfMemoryError 命令行参数，当抛出 java.lang.OutOfMemoryError 时，程序会生成 heap dump ：
java -XX:+HeapDumpOnOutOfMemoryError
默认情况下，它将 dump 存储在我们正在运行应用程序的目录中的 java_pid <pid> .hprof文件中。如果要指定另一个文件或目录，可以在 HeapDumpPath 参数中进行设置：
java -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=<file-or-dir-path>
使用此参数，当我们的应用程序内存不足时，我们将能够在日志中看到包含 dump 的已创建文件：
java.lang.OutOfMemoryError: Requested array size exceeds VM limit
Dumping heap to java_pid12587.hprof ...
Exception in thread "main" Heap dump file created [4744371 bytes in 0.029 secs]
java.lang.OutOfMemoryError: Requested array size exceeds VM limit
at com.baeldung.heapdump.App.main(App.java:7)
在上面的示例中，它已写入到 java_pid12587.hprof 文件中。
就像我们看到的，此参数非常有用，使用此参数运行应用程序时没有任何开销。因此，强烈建议始终使用此参数，尤其是在生产中。
最后，还可以在运行时通过使用 HotSpotDiagnostic MBean 来指定此参数。为此，我们可以使用 JConsole 工具并将HeapDumpOnOutOfMemoryError VM 参数值设置为 true：
四、JMX
我们将使用在上一节中简要介绍的 HotSpotDiagnostic MBean。该 MBean 提供了一个 dumpHeap 方法，该方法接受 2 个参数：
- outputFile：dump 文件的路径。该文件应具有 hprof 扩展名
- live：如果设置为 true，则它仅 dump 内存中的活动对象，就像我们之前在 jmap上看到的那样
下面我们将介绍两种不同的方法来调用此方法来 heap dump。
1、JConsole
使用 HotSpotDiagnostic MBean 的最简单方法是使用 JMX 客户端（例如JConsole）
打开 JConsole 并连接到正在运行的 Java 进程，则可以导航到 MBeans 选项卡并在 com.sun.management下找到HotSpotDiagnostic。在操作中，我们可以找到我们之前描述的 dumpHeap 方法：
如所示，为了执行 dumpHeap 操作，我们只需要引入参数 outputFile 并将其存在于 p0 和 p1 文本字段中。
2、编程
使用 HotSpotDiagnostic MBean 的另一种方法是通过从 Java 编程方式调用它。
为此，我们首先需要获取一个 MBeanServer 实例，以便获取在应用程序中注册的 MBean。之后，我们只需要获取 HotSpotDiagnosticMXBean 的实例 并调用其 dumpHeap 方法。
import javax.management.MBeanServer;
import java.io.IOException;
import java.lang.management.ManagementFactory;
import java.nio.file.Paths;
public class HeapDump {
public static void dumpHeap(String filePath, boolean live) throws IOException {
MBeanServer server = ManagementFactory.getPlatformMBeanServer();
HotSpotDiagnosticMXBean mxBean = ManagementFactory.newPlatformMXBeanProxy(
server, "com.sun.management:type=HotSpotDiagnostic", HotSpotDiagnosticMXBean.class);
mxBean.dumpHeap(filePath, live);
}
public static void main(String[] args) throws IOException {
String file = Paths.get("dump.hprof").toFile().getPath();
dumpHeap(file, true);
}
}
注意，不能覆盖 hprof 文件。因此，在创建打印 heap dumps 的应用程序时应该考虑到这一点。如果我们没有这样做，就会得到一个异常:
Exception in thread "main" java.io.IOException: File exists
at sun.management.HotSpotDiagnostic.dumpHeap0(Native Method)
at sun.management.HotSpotDiagnostic.dumpHeap(HotSpotDiagnostic.java:60)
五、Arthas
Arthas 是阿里提供的一款 Java 开源诊断工具。能够查看应用的线程状态、JVM 信息等；并能够在线对业务问题诊断，比如查看方法调用的出入参数、执行过程、抛出的异常、输出方法执行耗时等，大大提升了线上问题的排查效率。
Arthas 提供 heapdump 命令：dump java heap, 类似 jmap命令的 heap dump功能。
dump 到指定文件：
[arthas@58205]$ heapdump /tmp/dump.hprof
Dumping heap to /tmp/dump.hprof...
Heap dump file created
只 dump live对象：
[arthas@58205]$ heapdump --live /tmp/dump.hprof
Dumping heap to /tmp/dump.hprof...
Heap dump file created
dump 到临时文件：
[arthas@58205]$ heapdump
Dumping heap to /var/folders/my/wy7c9w9j5732xbkcyt1mb4g40000gp/T/heapdump2019-09-03-16-385121018449645518991.hprof...
Heap dump file created
更多参考：https://arthas.gitee.io/heapdump.html
六、结论
在本文中，我们展示了用 Java 捕获 Heap Dump 方法 的多种方法。
常见的dump方式
从经验上来说，我们应该记得在运行 Java 应用程序时始终使用 HeapDumpOnOutOfMemoryError 参数。