使用JavaScript调用Jira REST API失败，请求排查问题原因

首先可以明确：这个问题和Jira API认证本身无关——既然curl请求能正常返回结果，说明你的个人访问令牌（Personal Access Token）有效，请求的认证头格式也没问题。问题出在浏览器环境和fetch请求的特殊限制上，以下是具体的排查方向和修复方案：

1. 跨域资源共享（CORS）限制 #

浏览器会强制执行同源策略，只有当目标服务器明确允许你的SPA域名发起跨域请求时，fetch才能成功。而curl作为命令行工具不受这个限制。

• 排查方法：打开Chrome开发者工具的「Network」面板，查看失败请求的「Response Headers」，如果没有Access-Control-Allow-Origin字段，或者该字段的值不包含你的SPA域名，就是CORS问题。
• 修复方案：
  • 联系Jira服务器管理员，在Jira的CORS配置中添加你的SPA域名（比如https://your-spa-domain.com）；
  • 或者在你的后端搭建一个代理服务，由后端转发Jira请求（后端请求不受浏览器同源策略限制），SPA只请求自己的后端接口。

2. URL参数未编码 #

如果issueId包含特殊字符（比如空格、&、=等），直接拼接URL会导致请求格式错误。虽然你的示例中issueId是PROJ1-123没问题，但代码中没有做通用的编码处理，可能在其他场景出错，也可能浏览器对未编码的URL做了更严格的拦截。

• 修复代码：

async function getJiraIssue(issueId) {        
    try {
        // 对issueId进行URL编码，避免参数格式错误
        let encodedIssueId = encodeURIComponent(issueId);
        let uri = `https://my.jira.server/rest/api/latest/search?jql=id=${encodedIssueId}`;
        let response = await fetch(uri, {
            headers: {'Authorization': `Bearer MYJIRAPERSONALACCESSTOKEN`},
            redirect: 'follow' // 改为跟随重定向，避免重定向导致错误
        });
        // 额外检查响应状态码，处理非2xx的情况
        if (!response.ok) {
            throw new Error(`HTTP error! status: ${response.status}`);
        }
        let data = await response.json();
        return data;
    } catch (err) {
        return Promise.reject(err);
    }
}

3. redirect参数设置问题 #

你设置了redirect: 'error'，如果Jira服务器存在重定向（比如HTTP自动跳转HTTPS、路径末尾补加斜杠等），浏览器会直接抛出错误，而curl默认会自动跟随重定向。

• 修复：将redirect改为'follow'（默认值），或者先确认Jira的请求URL是否完全正确，不存在重定向情况。

4. 浏览器混合内容限制 #

如果你的SPA运行在HTTP协议下，而Jira服务器用的是HTTPS，浏览器会阻止这种「混合内容」请求，因为HTTP是不安全的协议。

• 修复：确保你的SPA也使用HTTPS协议部署（本地开发可以用localhost的HTTPS，比如用webpack-dev-server开启HTTPS）。

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