本文详解如何为长期运行的 Java 应用配置 JFR（Flight Recorder）自动轮转，通过 maxage 和 maxsize 参数实现按时间或大小切分录制文件，并规避默认录制导致的资源浪费。
本文详解如何为长期运行的 java 应用配置 jfr（flight recorder）自动轮转，通过 `maxage` 和 `maxsize` 参数实现按时间或大小切分录制文件，并规避默认录制导致的资源浪费。
Java Flight Recorder（JFR）是 JVM 内置的高性能诊断与监控工具，适用于生产环境的低开销事件采集。然而，对于持续运行数天甚至数周的服务（如每周运行 6 天的后台应用），若仅依赖 dumponexit=true，将导致单个 .jfr 文件累积全部运行期间的事件——不仅体积庞大（可能达数 GB）、加载分析缓慢，还存在内存与磁盘风险。JFR 本身不支持 FIFO 覆盖式写入，但原生支持基于时间或大小的自动轮转（rotation）机制，只需合理配置 FlightRecorderOptions 即可实现。
✅ 正确启用轮转：maxage 与 maxsize
轮转由 maxage（最大保留时长）或 maxsize（单文件最大体积）触发，二者可单独使用，也可组合（优先满足任一条件即轮转）。轮转时，JFR 会自动关闭当前录制、生成新文件，并在文件名中追加时间戳（格式为 yyyy_MM_dd_HH_mm_ss），确保文件唯一且可追溯。
▪ 按时间轮转（推荐用于周期性运维场景）
-XX:FlightRecorderOptions=\ defaultrecording=false,\ dumponexit=true,\ dumponexitpath=$APP_HOME/logs/$APP_NAME.jfr,\ maxage=24h
✅ 效果：每 24 小时生成一个新 .jfr 文件（如 myapp_2024_05_20_14_30_00.jfr），旧文件保留在磁盘，直至被外部清理策略处理。
⚠ 注意：dumponexitpath 中的 $APP_NAME.jfr 是模板路径，实际生成的文件名含自动添加的时间戳，因此无需在路径中手动拼接 $NOW 变量（否则会导致静态文件名冲突或轮转失效）。
▪ 按大小轮转（推荐用于高事件密度服务）
-XX:FlightRecorderOptions=\ defaultrecording=false,\ dumponexit=true,\ dumponexitpath=$APP_HOME/logs/$APP_NAME.jfr,\ maxsize=1g
✅ 效果：当当前录制文件达到 1 GB 时，立即关闭并启动新录制，新文件名同样带时间戳。
? 提示：maxsize 支持单位 k/m/g（如 512m、2g），数值为近似阈值，JFR 会在下一次事件批处理时检查并触发轮转，非严格实时。
⚠ 关键配置注意事项
务必设置 defaultrecording=false
原问题中使用的 defaultrecording=true 会使 JVM 启动时自动开启默认录制。若未显式停止，该录制将持续运行至进程退出，与轮转逻辑冲突，且占用额外资源。轮转需由显式启动的录制（如通过 JMX 或 jcmd）配合 maxage/maxsize 控制，而非依赖默认录制。正确做法是：禁用默认录制，再通过运维脚本或管理接口按需启动带轮转参数的录制。dumponexit=true 仅影响 JVM 退出时的最终快照
它不会干扰轮转过程，仅在进程终止瞬间将当前正在录制的文件（可能是轮转后的最新分片）额外保存一份到指定路径。若仅需轮转文件，可省略此参数。-
路径权限与磁盘空间需提前规划
轮转会产生多个文件，建议将 dumponexitpath 指向专用日志目录，并配合 logrotate 或定时任务清理过期文件（例如保留最近 7 天）：# 示例：删除 7 天前的 JFR 文件 find $APP_HOME/logs -name "*.jfr" -mtime +7 -delete
? 总结：最佳实践配置模板
# 推荐启动参数（移除已废弃的 UnlockCommercialFeatures）
JFR_OPTS="-XX:+UnlockDiagnosticVMOptions \
-XX:FlightRecorderOptions=\
defaultrecording=false,\
stackdepth=128,\
maxage=24h,\
repository=$APP_HOME/logs/jfr_repo,\
disk=true,\
settings=profile"✅ 说明：
java-api-doc-generator下载分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- repository 指定临时录制数据存储目录（必须存在且可写），提升 I/O 稳定性；
- disk=true 启用磁盘持久化（必选，否则轮转无效）；
- settings=profile 使用轻量级预设（平衡性能与信息量）；
- 所有参数用反斜杠 \ 换行，避免 shell 解析错误。
通过以上配置，您的长期运行应用即可实现自动化、可管理的 JFR 数据采集，兼顾诊断深度与运维可持续性。
立即学习“Java免费学习笔记（深入）”；
