如何在Jenkins插件中获取上一次成功构建的制品报告至当前构建

我来帮你解决这个Jenkins插件里获取历史构建报告的问题～ 你之前遇到的空指针、文件找不到问题，主要是因为对Jenkins的构建 artifacts 存储机制和API使用方式理解有点偏差，下面给你详细的解决方法：

问题根源分析 #

• getArtifactsDir() 返回null：这个方法仅对当前正在运行的构建有效，历史构建的本地 artifacts 目录可能已经被清理或者归档到了其他位置（比如Jenkins master的归档存储、远程节点），所以调用历史构建的这个方法会返回null。
• 直接拼接 root() 字符串：getArtifactManager().root() 返回的是 FilePath 对象，不是字符串路径，直接拼接会得到类似 FilePath@xxxx 的无效路径，自然找不到文件。

正确的实现步骤 #

1. 先校验历史构建是否存在 #

首先要确保上一次成功构建存在，避免空指针异常：

Run<?, ?> previousSuccessBuild = build.getPreviousSuccessfulBuild();
if (previousSuccessBuild == null) {
    // 处理没有历史成功构建的场景，比如打印日志或返回提示
    LOGGER.info("No previous successful build found");
    return;
}

2. 使用 FilePath 安全获取归档文件 #

Jenkins的 ArtifactManager 和 FilePath 是专门用来处理跨节点、跨存储的文件操作的，用它们来获取历史构建的artifacts才可靠：

// 获取上一次成功构建的artifacts根目录
FilePath artifactsRoot = previousSuccessBuild.getArtifactManager().root();
// 拼接报告文件的相对路径（REPORT_TEMPLATE_PATH是你的报告相对路径）
FilePath reportFilePath = artifactsRoot.child(REPORT_TEMPLATE_PATH);

// 检查文件是否存在
if (reportFilePath.exists()) {
    // 读取报告内容（示例：读取为字符串）
    String reportContent = reportFilePath.readToString();
    // 这里写你后续的逻辑，比如对比当前报告和历史报告的变化
} else {
    LOGGER.warning("Report file not found in previous successful build: " + REPORT_TEMPLATE_PATH);
}

3. 补充：确保生成的报告被正确归档 #

另外要注意，你在生成报告的时候，必须把文件添加到构建的artifacts归档中，否则历史构建的 ArtifactManager 找不到它。生成报告后添加归档的代码示例：

// 假设你已经生成了reportFile文件
FilePath reportFile = new FilePath(new File(artifactsDir.getCanonicalPath() + REPORT_TEMPLATE_PATH));
// 将文件归档到构建artifacts中
build.getArtifactManager().archive(reportFile, REPORT_TEMPLATE_PATH, false);

额外提示 #

• 尽量避免直接使用 File 类操作Jenkins的构建文件，优先用 FilePath，它能处理Jenkins分布式架构下的跨节点文件访问。
• 如果你的Jenkins启用了artifacts归档压缩（比如ZIP归档），ArtifactManager 会自动帮你解压缩访问，不用手动处理。

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