ExtentReports在Jenkins显示空白但本地HTML文件生成正常问题排查

可能原因及解决步骤 #

• 检查HTML Publisher插件配置
  确认Jenkins的HTML Publisher插件设置里，是否正确指定了主HTML文件路径。如果配置的是htmlpublisher-wrapper.html而不是实际的testReport.html，就会导致加载空白文件。需要在插件配置的HTML directory to archive和Index page[s]中，将入口文件设置为testReport.html，而非自动生成的wrapper文件。
• 验证归档路径的正确性
  确保归档路径是相对于Jenkins工作空间的正确路径，比如如果testReport.html在target/reports/下，归档路径应设为target/reports，索引页设为testReport.html。避免路径层级错误导致插件找不到实际报告文件，进而生成空的wrapper。
• 检查文件权限问题
  Jenkins运行用户可能没有读取testReport.html及相关截图文件的权限。在Jenkins服务器上手动检查归档目录下的文件权限，确保Jenkins进程用户（通常是jenkins）对这些文件有读权限。
• 禁用HTML Publisher的wrapper生成（可选）
  部分版本的HTML Publisher插件会自动生成htmlpublisher-wrapper.html，如果这个过程异常导致文件为空，可以尝试在插件配置中找到禁用wrapper的选项（部分版本支持），直接让Jenkins加载原始的testReport.html。
• 确认ExtentReports生成的报告兼容性
  部分ExtentReports版本生成的HTML结构可能与HTML Publisher插件的解析逻辑冲突。尝试更新ExtentReports到稳定版本，或检查报告中是否存在未闭合的HTML标签、特殊字符等导致插件无法正确渲染的问题。
• 检查Jenkins日志
  查看Jenkins系统日志（路径通常为/var/log/jenkins/jenkins.log或Jenkins后台的日志页面），搜索与HTML Publisher相关的报错信息，可能会找到生成wrapper文件失败的具体原因，比如文件读写错误、路径解析异常等。

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