Azure Synapse调用Jira REST API触发错误21155，寻求解决办法

1. 排查响应内容类型 #

错误提示中的<字符说明Synapse收到的是HTML内容（比如Jira登录页、权限错误页），而非预期的JSON。即使Postman请求正常，Synapse的请求可能因认证配置错误未通过Jira校验：

• 核对认证方式：Jira API常用Basic Auth（邮箱+API令牌）或OAuth2，确保Synapse中的认证信息与Postman完全一致：
  • Basic Auth场景下，用户名是Jira注册邮箱，密码是Jira生成的API令牌（而非账号登录密码）
  • OAuth2场景下，确认授权流程的回调地址、令牌有效期等配置无误
• 开启Synapse连接器的响应日志，查看实际返回的内容，确认是否为HTML错误页

2. 补全请求头部配置 #

Postman会自动添加部分必要头部，Synapse需手动配置：

• 强制添加Accept: application/json头部，确保Jira返回JSON格式
• 若为POST/PUT请求，设置Content-Type: application/json头部
• 对比Postman的请求头部列表，将所有必要头部复制到Synapse连接器的请求头部设置中

3. 校验请求路径与参数 #

• 确认API路径是否完整，比如是否遗漏/rest/api/3这类版本前缀
• 检查参数编码：若查询参数包含空格、特殊字符，在Synapse动态内容中用encodeURIComponent()手动编码，避免解析异常

4. 调整JSON解析配置 #

在Synapse REST连接器的源设置中：

• 开启Allow trailing commas和Ignore comments选项，兼容Jira返回的JSON格式细节
• 设置响应编码为UTF-8，避免因编码问题导致的字符解析错误

5. 简化请求测试 #

先调用Jira的简单API（如/rest/api/3/serverInfo）验证Synapse能否正常获取JSON响应，再逐步添加复杂参数或路径，定位具体问题点

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