Jenkins Extent报告图片无法显示，报Jetty StaticException异常

问题概述 #

CentOS环境下的Jenkins独立版（基于Jetty运行），构建Java Selenium项目后通过HTML Publisher插件生成带截图的Extent报告，打开报告时图片显示404未找到，Jetty日志抛出org.eclipse.jetty.util.StaticException: Unconsumed content异常。已确认图片实际存在于服务器对应路径，且已禁用Jenkins内容安全策略（CSP）。

核心原因 #

Jetty默认不会直接映射服务器本地文件系统的绝对路径到HTTP请求路径，日志中请求的URI直接使用/var/lib/jenkins/workspace/...这类本地绝对路径，Jetty无法识别并正确处理该请求，进而触发未消费内容的异常。

解决方案 #

方案1：修正HTML Publisher插件路径配置（推荐） #

1. 进入Jenkins对应构建任务的配置页面，找到HTML Publisher配置项
2. 将HTML directory to archive设置为相对路径（相对于项目工作空间根目录），例如Reports/extentReport_*（匹配你的报告目录命名规则），避免使用绝对路径
3. 确认Index page[s]填写正确的报告入口文件，如index.html
4. 可选勾选Keep past HTML reports以保留历史报告
5. 重新执行构建任务，Jenkins会自动将报告目录作为工作空间子目录归档，Jetty将通过Jenkins内置的资源映射规则正确访问图片

方案2：调整Extent报告图片路径生成逻辑 #

在Selenium代码中生成截图时，使用相对路径替代绝对路径：

// 原绝对路径写法（不推荐）
String screenshotPath = "/var/lib/jenkins/workspace/SecOps Automation/Reports/extentReport_xxx/" + screenshotName;
// 修改为相对路径（相对于项目工作空间根目录）
String screenshotPath = "./Reports/extentReport_xxx/" + screenshotName;

修改后Extent报告生成的图片链接为相对路径，HTML Publisher归档后可被Jenkins正确解析。

方案3：配置Jetty资源映射（仅必要时使用） #

若必须使用绝对路径，需修改Jenkins的Jetty配置：

1. 找到Jenkins启动配置文件（通常为/etc/sysconfig/jenkins或启动脚本），添加Jetty资源映射参数：

   --webroot=/var/lib/jenkins/workspace --context-path=/jenkins-workspace-resources
   

2. 重启Jenkins服务：

   systemctl restart jenkins
   

3. 修改Extent报告中的图片路径，将绝对路径替换为/jenkins-workspace-resources/SecOps Automation/Reports/.../xxx.jpg

验证步骤 #

1. 重新执行构建任务生成新报告
2. 在Jenkins中打开报告，确认图片正常显示
3. 查看Jetty日志（默认路径/var/log/jenkins/jenkins.log），确认Unconsumed content异常不再出现

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