如何在JMC 8中生成可正常展示的HTML格式JFR报告

解决方案 #

• 补全运行依赖的jar包
  你当前配置的CLASSPATH缺少规则实现、HTML报告生成模块的相关依赖，无需手动逐个筛选jar，直接将JMC 8解压后根目录下的plugins文件夹内所有jar加入classpath即可，调用命令示例：

java -cp "plugins/*" org.openjdk.jmc.flightrecorder.rules.report.html.JfrHtmlRulesReport test.jfr output.html

Windows环境下注意路径的引号处理，避免空格导致的路径识别错误。

• 更换运行的JDK版本
  JMC 8的核心运行环境要求为JDK 11及以上版本，你当前使用的JDK 8存在类兼容性问题，会导致规则计算逻辑无法正常执行，仅生成空的报告框架。换用JDK 11或更高版本重新执行生成命令即可解决无内容问题。

• 校验JFR文件兼容性
  如果JFR文件是JDK 8u40之前版本生成的旧格式，JMC 8的解析逻辑会存在适配问题。你可以先在JMC 8的图形化界面中打开对应JFR文件，确认文件可以被正常解析、能看到各项记录数据，再尝试生成HTML报告。

• 修复报告展示异常
  如果生成的报告图片无法加载，不要修改生成后HTML文件的存储路径，保证HTML文件和同目录下的静态资源文件放在同一文件夹下，同时避免文件路径包含中文、特殊字符，直接在浏览器打开本地HTML文件即可正常展示内容。

内容的提问来源于stack exchange，提问作者Mario.Cadiz