关于Zephyr与Eclipse项目集成及Karate框架自动化测试结果同步至Zephyr Board的技术咨询

阿华AIGC实验室

2026-4-21

Karate框架API自动化测试结果同步至Zephyr Board的实现方案

当然可以实现Karate测试结果自动同步到Zephyr Board，完全不用局限在Jira内部运行脚本——批量测试用例的场景也能轻松搞定，下面给你几个实用的方案：

方案一：直接调用Zephyr Scale REST API

Karate本身就是做HTTP请求的好手，我们可以利用它的钩子功能，在每个测试用例执行完成后，主动调用Zephyr的API更新状态：

关联测试用例：先给Karate的Scenario加上明确的标识，比如把Zephyr的测试用例Key（比如TC-123）放在Scenario名称里，或者用Karate的标签@TC-123来关联。
编写全局钩子：在karate-config.js或者单独的钩子文件里，添加After钩子来捕获测试结果：

After(function(scenario) {
    // 从Scenario标签中提取Zephyr测试用例Key
    const testCaseKey = scenario.getTags().find(tag => tag.startsWith('@TC-')).replace('@', '');
    const status = scenario.isPassed() ? "PASS" : "FAIL";
    
    // 调用封装好的Zephyr更新接口
    karate.call('classpath:zephyr/update-status.feature', { 
        testCaseKey: testCaseKey, 
        executionStatus: status 
    });
});

封装Zephyr API调用：写一个单独的feature文件update-status.feature来处理HTTP请求，带上Zephyr的认证信息（API密钥或Jira token）：

Feature: Update Zephyr Test Case Status

  Scenario: Update status for a test case
    Given url 'https://api.zephyrscale.smartbear.com/v2/testcases/' + testCaseKey + '/executions'
    And header Authorization = 'Bearer ' + karate.properties['zephyr.api.token']
    And header Content-Type = 'application/json'
    And request { statusName: '#(executionStatus)' }
    When method post
    Then status 200

这样每次Karate测试跑完，就会自动把结果同步到对应的Zephyr测试用例上。

方案二：通过CI/CD工具批量同步（推荐批量场景）

如果你们用Jenkins、GitHub Actions这类CI工具跑Karate测试，这个方案更高效：

生成标准JUnit报告：在Karate配置里开启JUnit报告输出，这样测试结果会生成通用的XML格式：

karate.configure('report', { 
    junit: true, 
    outputDir: 'target/test-reports',
    reportName: 'karate-api-tests'
});

集成Zephyr Scale CI插件：在CI工具里安装Zephyr Scale的官方插件（比如Jenkins的Zephyr Scale插件），配置好Jira/Zephyr的认证信息。
批量导入报告：在CI任务中，跑完Karate测试后，添加一个步骤让插件读取JUnit报告，自动匹配Zephyr里的测试用例（可以通过测试用例名称、标签或者自定义字段关联），批量更新状态。
这种方式不用给每个测试用例写钩子，适合大量测试用例的场景，维护成本更低。