Java程序JIRA认证失败，如何正确传递JIRA_USER与JIRA_PASS凭证？

核心问题分析 #

你遇到的401未授权+JSON解析异常，本质是两个关联问题：

1. JIRA认证失败，服务器返回HTML登录页而非预期的JSON响应
2. 凭证传递或API请求逻辑存在错误

解决方案步骤 #

1. 修正凭证传递方式（敏感信息只在运行时传入）

首先，打包时不要附带JIRA凭证，敏感信息不应打包进jar包，正确的打包命令：

mvn clean install -DskipTests=true

运行jar时，JVM参数（-D开头的）必须放在-jar之前，你的命令格式本身没问题，但要注意凭证的正确性：

java -DJIRA_USER="你的JIRA账号/邮箱" -DJIRA_PASS="你的JIRA密码/API Token" -jar target\dita-1.0.0-SNAPSHOT.jar "RG Desktop 1.21.0"

重要提示：如果是Atlassian Cloud版JIRA，禁止使用账号密码直接登录，必须用「邮箱作为JIRA_USER」+「API Token作为JIRA_PASS」，API Token可在Atlassian个人账号设置中生成。

2. 确保Spring Boot正确读取参数

在应用代码中，必须通过Spring的配置机制读取这些JVM参数，比如用@Value注解：

@Service
public class JiraClient {
    @Value("${JIRA_USER}")
    private String jiraUsername;

    @Value("${JIRA_PASS}")
    private String jiraCredential;

    // 后续调用JIRA API时使用这两个参数
}

也可以通过Environment对象获取参数：

@Autowired
private Environment env;

public void initJiraAuth() {
    String user = env.getProperty("JIRA_USER");
    String pass = env.getProperty("JIRA_PASS");
}

3. 修复JIRA API请求的认证与响应格式

调用JIRA API时，必须同时设置基本认证头和Accept请求头，否则会返回HTML登录页导致JSON解析失败：

// 构建Base64认证字符串
String authToken = Base64.getEncoder()
    .encodeToString((jiraUsername + ":" + jiraCredential).getBytes(StandardCharsets.UTF_8));

HttpHeaders headers = new HttpHeaders();
headers.set("Authorization", "Basic " + authToken);
// 关键：强制要求返回JSON格式，避免返回HTML登录页
headers.setAccept(Collections.singletonList(MediaType.APPLICATION_JSON));

HttpEntity<String> entity = new HttpEntity<>(headers);
// 发送API请求示例
RestTemplate restTemplate = new RestTemplate();
ResponseEntity<JiraIssueDto> response = restTemplate.exchange(
    "https://你的JIRA域名/rest/api/2/issue/KEY-123",
    HttpMethod.GET,
    entity,
    JiraIssueDto.class
);

4. 快速验证凭证有效性

用curl命令单独验证JIRA凭证是否有效，排除应用代码问题：

# Cloud版JIRA验证示例
curl -u "你的邮箱:你的API Token" -H "Accept: application/json" https://your-domain.atlassian.net/rest/api/2/myself

# 服务器版JIRA验证示例
curl -u "你的账号:你的密码" -H "Accept: application/json" http://your-jira-server/rest/api/2/myself

如果返回JSON格式的用户信息，说明凭证正确；如果返回401，检查凭证是否有误；如果返回HTML，确认是否添加了Accept: application/json头。

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