如何从Jenkins上传Java Selenium TestNG Extent测试报告至GCS存储桶？

核心原因分析 #

Extent测试报告并非单一HTML文件，它通常包含主HTML文件和关联的静态资源目录（比如同级的assets文件夹，存储截图、样式文件等）。如果仅指定单个HTML文件上传，不仅会丢失依赖资源，插件也可能无法正确识别目录结构导致上传失败。

具体解决方案 #

1. 配置插件上传整个报告目录 #

在“Google storage classic upload”构建步骤中：

• 源文件：填写Extent报告所在目录的通配符，比如**/extent-reports/**（假设报告生成在项目根目录的extent-reports文件夹下），或精确路径target/extent-reports/*（根据实际生成路径调整）。
• 目标路径：设置GCS存储桶内的目标目录，比如jenkins-test-reports/${BUILD_NUMBER}/（用Jenkins环境变量区分不同构建的报告）。
• 勾选Upload entire directory structure选项，确保完整上传目录结构，保证HTML内的截图链接能正常访问。

2. 确认报告生成路径正确性 #

在Jenkins任务的构建步骤中，确保Extent报告生成在Jenkins工作空间内，比如用命令行指定绝对路径：

# 示例：Maven项目指定报告输出到工作空间目录
mvn test -Dextent.reporter.html.outputDir=${WORKSPACE}/extent-reports

避免使用相对路径导致插件无法定位文件。

3. 验证GCS权限与插件配置 #

• 确认Jenkins绑定的GCS服务账号拥有storage.objects.create权限，可向目标存储桶写入文件。
• 检查Jenkins全局配置中的“Google Cloud Storage”项，确保服务账号密钥有效、存储桶名称无误。

4. 分步排查问题 #

如果问题仍存在，先尝试上传单个测试文件（比如单独的截图或HTML），确认插件能正常连接GCS，再逐步扩展到整个目录，排查是否为路径或通配符配置错误。

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