使用jira-rest-java-client访问Jira测试用例遇404错误求助

Jira中的测试用例（无论原生Issue类型还是插件扩展的测试用例）本质都是Issue，因此使用getIssue接口是可行的，但你的依赖配置和代码存在关键问题，导致404错误。

一、修正Maven依赖配置 #

你的jira-rest-java-client-core依赖使用了<scope>provided</scope>，该作用域表示依赖由运行环境提供，但本地运行时无对应环境，会导致找不到客户端实现类，进而引发请求失败。修改如下：

<dependency>
    <groupId>com.atlassian.jira</groupId>
    <artifactId>jira-rest-java-client-api</artifactId>
    <version>5.2.4</version>
</dependency>
<dependency>
    <groupId>com.atlassian.jira</groupId>
    <artifactId>jira-rest-java-client-core</artifactId>
    <version>5.2.4</version>
    <!-- 移除provided作用域，默认compile即可 -->
</dependency>

二、补全客户端初始化与认证代码 #

你的代码缺少JiraRestClient的创建和认证逻辑，直接调用client.getIssueClient()会导致无效请求，这是404的核心原因之一。完整可运行代码如下：

import com.atlassian.jira.rest.client.api.JiraRestClient;
import com.atlassian.jira.rest.client.api.domain.Issue;
import com.atlassian.jira.rest.client.auth.BasicHttpAuthenticationHandler;
import com.atlassian.jira.rest.client.internal.async.AsynchronousJiraRestClientFactory;

import java.net.URI;

public class JiraTestcaseAccessor {
    public static void main(String[] args) {
        String jiraUrl = "https://mockrun-jira.xxxxxx.com";
        String username = "xxx";
        String token = "<MASK>"; // Jira个人访问令牌
        String issueKey = "XX-T1234";

        // 初始化带认证的Jira客户端
        JiraRestClientFactory factory = new AsynchronousJiraRestClientFactory();
        JiraRestClient client = factory.create(
                URI.create(jiraUrl),
                new BasicHttpAuthenticationHandler(username, token)
        );

        try {
            // 获取测试用例（Issue）
            Issue issue = client.getIssueClient().getIssue(issueKey).claim();
            System.out.println("测试用例标题: " + issue.getSummary());
            // 若为Xray等插件的测试用例，可通过自定义字段获取测试步骤等内容
            // Field testStepsField = issue.getFieldByName("Test Steps");
            // System.out.println("测试步骤: " + testStepsField.getValue());
        } finally {
            // 关闭客户端释放资源
            client.close();
        }
    }
}

三、后续404排查点 #

若修正后仍出现404，检查以下内容：

• 确认XX-T1234测试用例确实存在，且Issue Key拼写完全正确（区分大小写）
• 验证你的账号（用户名+令牌）拥有该测试用例所在项目的浏览权限
• 确认Jira服务器地址可正常访问，无网络防火墙或代理拦截
• 检查Jira实例是否开启了API访问限制

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