JIRA Webhook无法向Azure Function App发送JSON负载排查咨询

JIRA端排查项 #

• 核对Webhook触发配置：确认Webhook仅勾选「创建问题」事件，且项目范围覆盖目标项目，避免因事件/项目范围不匹配导致未触发请求。
• 查看Webhook请求日志：在JIRA系统设置→Webhooks中找到对应Webhook，点击「查看日志」，重点关注请求状态码（如401/403/500）、响应信息，排查授权失败、连接超时等问题。
• 验证请求URL正确性：对比手动测试的URL，确认JIRA配置的URL是否包含正确的Azure Function密钥（格式如?code=xxx），检查URL是否存在拼写错误或特殊字符导致解析失败。
• 检查出站访问限制：确认JIRA实例（尤其是云版）的防火墙/代理规则允许访问Azure域名（azurewebsites.net），避免请求被拦截。

Azure Function端排查项 #

• 检查访问限制策略：在Azure门户的Function App→网络→访问限制中，确认JIRA的出站IP地址已加入白名单，防止因IP拦截导致请求无法到达。
• 验证授权级别与密钥：确认Function的授权级别为「函数」时，JIRA请求URL携带的密钥与当前有效密钥一致，排查密钥过期、修改或遗漏的情况。
• 查看平台级日志：若Function无调用记录，需查看App Service日志（Azure门户→Function App→监控→日志→App Service日志），排查是否有来自JIRA的请求被拒绝（如403/401）或连接异常的记录。
• 核对请求格式与触发器配置：确认JIRA发送的请求Content-Type为application/json，且Function的HTTP触发器允许POST方法；检查触发器路由是否与JIRA配置的URL路径完全匹配。
• 排查负载兼容性：对比手动测试的JSON负载与JIRA实际发送的内容，确认是否存在编码差异（如UTF-8 BOM）或特殊字段导致请求在进入Function执行层前被拦截。

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