JFR参数filename的含义是什么？程序退出后文件为何为空？

问题背景 #

我通过C++代码启动JDK18 JVM以生成VST插件，目标是在Java端实现音频信号算法，同时借助完整Java GUI API的优势。我的框架运行顺畅，但存在可复现的问题：音频流会在14小时后崩溃。因此我打算学习JFR排查问题，我的JVM启动参数配置在XML文件中，相关部分如下：

<param>
    -XX:StartFlightRecording,dumponexit=true,filename=c:/out/blackbox.jfr
</param>

但即使程序退出后，指定的文件仍为空。请问filename参数的作用是什么？该如何正确使用它？

回答 #

filename参数的作用 #

filename是JFR（Java Flight Recorder）启动参数中的核心配置项，用于指定飞行记录数据的输出文件路径。当配合dumponexit=true使用时，JVM正常退出时会将全程录制的JFR数据写入该文件；如果设置了disk=true参数，JFR还会在录制过程中实时将数据写入该文件，避免异常退出时丢失记录。

空文件问题的原因及解决方法 #

• 目录权限或路径问题
  先确认c:/out/目录是否存在，若不存在需手动创建。同时检查运行VST插件的进程是否拥有该目录的读写权限——很多音频宿主程序（如DAW）会以受限权限运行，导致JVM无法写入该路径。可以尝试将输出路径改为用户目录下的可写位置，比如c:/users/[你的用户名]/documents/blackbox.jfr。

• 参数格式错误
  JDK18中-XX:StartFlightRecording的参数格式需要用等号将选项组包裹，正确写法如下：

  <param>
      -XX:StartFlightRecording=dumponexit=true,filename=c:/out/blackbox.jfr
  </param>
  

  原写法缺少开头的等号，可能导致JVM无法正确解析参数组合，进而无法启动录制。

• 进程异常终止导致dump未触发
  音频流崩溃大概率是进程异常退出（如JVM崩溃、宿主程序强制终止），这种情况下dumponexit=true不会触发——因为JVM没有机会执行退出时的dump操作。此时必须添加disk=true参数，让JFR实时将录制数据写入磁盘：

  <param>
      -XX:StartFlightRecording=dumponexit=true,filename=c:/out/blackbox.jfr,disk=true,maxsize=1024m,maxage=24h
  </param>
  

  其中maxsize限制单个JFR文件的最大大小，maxage限制数据保留的最长时间，防止磁盘被占满。

• JFR录制未实际启动
  可以通过JDK自带的jcmd工具检查JFR状态：找到VST对应的JVM进程ID，执行jcmd [PID] JFR.check，如果返回"Recording not found"，说明录制未成功启动，需要检查是否有其他JVM参数冲突（比如-Xint禁用JIT会影响JFR）。

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