如何通过JIRA REST API添加远程问题链接？Java库相关困惑求解

我之前也碰到过这个棘手的问题！Atlassian官方的JIRA Java客户端确实存在一些REST端点封装不全的情况，remoteLink这块就是个典型例子。这里给你几个实用的解决思路，你可以根据自己的场景选择：

1. 直接调用原始REST API（最推荐） #

既然Java客户端没有封装remoteLink的创建接口，咱们直接绕开它，用HTTP客户端构造POST请求调用官方REST端点，这和你用Postman等工具测试的逻辑完全一致。这种方法兼容性最好，不依赖客户端版本，也不会有封装层的限制。

示例代码（用OkHttp实现） #

import okhttp3.MediaType;
import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.RequestBody;
import okhttp3.Response;
import java.io.IOException;
import java.util.Base64;

public class JiraS3RemoteLinkHelper {
    // 替换成你的JIRA实例地址、认证信息
    private static final String JIRA_BASE_URL = "https://your-jira-domain.com";
    private static final String JIRA_USER_EMAIL = "your-email@company.com";
    private static final String JIRA_API_TOKEN = "your-api-token";

    public static void createS3RemoteLink(String issueKey, String s3PresignedUrl, String linkDisplayName) throws IOException {
        OkHttpClient client = new OkHttpClient();

        // 构造符合JIRA remoteLink规范的JSON请求体
        String jsonPayload = String.format("""
            {
                "object": {
                    "url": "%s",
                    "title": "%s",
                    "summary": "S3预签名链接"
                },
                "globalId": "system=aws-s3,url=%s"
            }""", s3PresignedUrl, linkDisplayName, s3PresignedUrl);

        RequestBody body = RequestBody.create(
            jsonPayload,
            MediaType.get("application/json; charset=utf-8")
        );

        // 生成Basic认证头
        String authCredentials = JIRA_USER_EMAIL + ":" + JIRA_API_TOKEN;
        String base64Auth = Base64.getEncoder().encodeToString(authCredentials.getBytes());

        Request request = new Request.Builder()
            .url(JIRA_BASE_URL + "/rest/api/2/issue/" + issueKey + "/remotelink")
            .addHeader("Authorization", "Basic " + base64Auth)
            .post(body)
            .build();

        try (Response response = client.newCall(request).execute()) {
            if (!response.isSuccessful()) {
                throw new IOException("创建远程链接失败，响应状态码: " + response.code() + "，响应体: " + response.body().string());
            }
            System.out.println("S3远程链接已成功添加到JIRA问题 " + issueKey);
        }
    }
}

• 注意：globalId字段是可选的，但建议添加，它可以帮助JIRA识别重复链接，避免同一S3 URL被多次添加。
• 你也可以用其他HTTP客户端（比如Spring RestTemplate、Apache HttpClient）替换OkHttp，逻辑是一样的。

2. 尝试扩展官方JiraRestClient（兼容性较差） #

如果你坚持想用官方客户端的上下文（比如已经有初始化好的JiraRestClient实例），可以尝试通过反射或内部API获取底层的HTTP客户端，再发送自定义请求。不过这种方法对版本敏感，Atlassian更新客户端后可能失效，不推荐长期使用。

示例代码（基于AsynchronousJiraRestClient） #

import com.atlassian.jira.rest.client.api.JiraRestClient;
import com.atlassian.jira.rest.client.internal.async.AsynchronousJiraRestClient;
import com.atlassian.httpclient.api.HttpClient;
import com.atlassian.httpclient.api.Request;
import java.util.concurrent.CompletableFuture;

public class ExtendedJiraRemoteLinkService {
    private final JiraRestClient jiraRestClient;

    public ExtendedJiraRemoteLinkService(JiraRestClient jiraRestClient) {
        this.jiraRestClient = jiraRestClient;
    }

    public CompletableFuture<Void> createRemoteLink(String issueKey, String targetUrl, String linkTitle) {
        if (!(jiraRestClient instanceof AsynchronousJiraRestClient asyncClient)) {
            throw new IllegalArgumentException("仅支持AsynchronousJiraRestClient实现");
        }

        HttpClient httpClient = asyncClient.getHttpClient();
        String apiUrl = jiraRestClient.getBaseUri() + "/rest/api/2/issue/" + issueKey + "/remotelink";

        String jsonPayload = String.format("""
            {
                "object": {
                    "url": "%s",
                    "title": "%s"
                }
            }""", targetUrl, linkTitle);

        Request request = Request.newRequest()
                .setUri(apiUrl)
                .setMethod("POST")
                .setEntity(jsonPayload, "application/json")
                .build();

        return httpClient.execute(request)
                .thenApply(response -> {
                    if (response.getStatus() < 200 || response.getStatus() >= 300) {
                        throw new RuntimeException("创建远程链接失败，状态码: " + response.getStatus());
                    }
                    return null;
                });
    }
}

3. 检查并升级Jira Java Client版本 #

先确认你当前使用的Jira Java Client版本（比如jira-rest-client-core），去官方文档或Maven中央仓库查看最新版本。如果你的版本较旧，Atlassian可能在后续版本中添加了remoteLink的封装接口（比如RemoteLinkService或类似的资源类）。如果有，直接升级依赖并调用对应方法即可，这是最优雅的解决方案。

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