本地可生成Extent Reports，Bamboo构建仅出日志无报告问题

1. 权限问题 #

• Bamboo运行进程的服务账户（如bamboo用户）没有报告输出目录的读写权限，本地个人账户权限足够但服务账户受限。
• 解决：检查报告输出目录（如target/extent-reports）的权限，给Bamboo用户添加读写权限；或在Maven命令中指定Bamboo有权限的临时路径：

  mvn clean test -Dextent.reports.path=/tmp/bamboo-extent-reports
  

2. 相对路径不匹配 #

• 本地用相对路径（如./reports）生成报告，但Bamboo工作目录与本地不同，导致报告生成到未预期的位置。
• 解决：修改Extent Reports配置为绝对路径，或基于Maven内置变量动态获取路径：

  String reportDir = System.getProperty("project.build.directory") + "/extent-reports";
  ExtentReports extent = new ExtentReports(reportDir + "/index.html", true);
  

3. Maven构建阶段遗漏 #

• 本地手动执行了mvn site等报告生成阶段，但Bamboo任务仅执行mvn clean test，未触发报告生成插件。
• 解决：在Bamboo的Maven任务命令中添加报告生成目标，比如：

  mvn clean test site
  

  或直接指定Extent Reports插件目标：

  mvn clean test com.aventstack:extentreports-maven-plugin:generate
  

4. 依赖拉取不完整 #

• 本地仓库有完整的Extent Reports依赖，但Bamboo远程仓库未拉取到对应依赖，导致报告生成逻辑静默失败。
• 解决：在Bamboo任务中执行mvn clean install -U强制更新依赖；检查pom.xml中相关依赖的scope，避免设为provided（除非Bamboo代理已预装）。

5. Bamboo报告发布配置缺失 #

• 即使报告已生成，Bamboo未配置报告展示路径，导致无法在界面中查看。
• 解决：在Bamboo任务后添加**「发布HTML报告」**步骤，指定报告根目录（如target/extent-reports）和入口文件index.html，确保路径与实际生成位置一致。

6. 日志排查要点 #

• 查看Bamboo构建完整日志，搜索ExtentReports相关错误（如文件写入失败、类加载异常）；若日志无报错，检查代码是否根据环境变量跳过了报告生成逻辑。
• 解决：在代码中添加日志打印报告路径、权限检查结果；或在Bamboo任务中执行ls -l target/extent-reports，确认目录及文件是否存在。

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