如何将Java异常分类为2xx/4xx/5xx用于Jenkins插件指标统计

核心分类逻辑（类比HTTP状态码语义） #

因为不是API服务，我们把工作流状态对应到HTTP状态码的语义逻辑：

• 0（对应2xx成功）：工作流按预期完成，或主动终止的正常场景
• 1（对应4xx客户端错误）：问题源于插件自身配置、输入无效，属于执行方的错误
• 2（对应5xx服务端错误）：问题源于外部依赖故障、服务不可用，属于外部系统的错误

针对指定异常的分类规则 #

InterruptedException #

通常是Jenkins构建被用户取消、系统终止任务触发的中断，属于正常终止场景，归类为0。如果是意外的线程中断（极少见），可根据实际情况调整为2。

ParserConfigurationException、SAXException #

这两个都是XML解析相关异常，一般是插件配置文件格式错误、结构不符合预期导致的，属于插件自身配置问题，归类为1。

IOException #

需要根据错误原因细分：

• 归类为1：本地IO错误，比如配置文件不存在、权限不足、文件格式无效（对应子类如FileNotFoundException）
• 归类为2：外部服务通信错误，比如与SignalFX/其他依赖服务连接超时、拒绝连接（对应子类如ConnectException、SocketTimeoutException）

通用Exception #

作为兜底捕获，需根据具体错误场景判断：

• 归类为1：业务逻辑参数无效、本地配置错误等客户端问题
• 归类为2：外部服务抛出的未知错误、系统资源耗尽等服务端问题

代码实现示例 #

try {
    // 执行插件核心工作流逻辑
    runPluginWorkflow();
    // 正常完成，发送成功指标
    sendToSignalFX(0, workflowData);
} catch (InterruptedException e) {
    // Jenkins构建被取消/终止，属于正常终止
    sendToSignalFX(0, workflowData);
} catch (ParserConfigurationException | SAXException e) {
    // 配置解析错误，客户端类问题
    sendToSignalFX(1, workflowData);
} catch (IOException e) {
    // 细分IO错误类型
    if (isLocalIOError(e)) {
        sendToSignalFX(1, workflowData);
    } else {
        sendToSignalFX(2, workflowData);
    }
} catch (Exception e) {
    // 兜底处理，优先判断错误类型
    if (isClientSideError(e)) {
        sendToSignalFX(1, workflowData);
    } else {
        sendToSignalFX(2, workflowData);
    }
}

// 辅助方法：判断是否为本地IO错误（客户端类）
private boolean isLocalIOError(IOException e) {
    String errorMsg = e.getMessage().toLowerCase();
    // 根据常见错误关键词判断
    return e instanceof FileNotFoundException ||
           errorMsg.contains("permission denied") ||
           errorMsg.contains("invalid file format");
}

// 辅助方法：判断是否为客户端类错误
private boolean isClientSideError(Exception e) {
    return e instanceof IllegalArgumentException ||
           (e.getMessage() != null && e.getMessage().toLowerCase().contains("invalid input"));
}

注意事项 #

• 优先捕获具体异常，减少通用Exception的使用，提升分类准确性
• 可以通过异常的子类（而非仅message）来更精准判断错误类型，比如ConnectException直接归为2
• 针对Jenkins的特定场景，InterruptedException绝大多数情况是用户主动终止构建，归为0更合理

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