BlueGrove Labs 标志BlueGrove LabsStatusPath Reports
CTRL K

故障排查

本页帮助你在提交支持请求前诊断 StatusPath Reports 的常见问题。

联系支持时，请包含模块、报表类型、工作项范围、日期设置、Trim History、预期结果、实际结果和可见错误信息。

先检查基础项

  1. 当前 Jira 用户是否正确。
  2. 报表类型是否正确。
  3. Work item scope 是否选择了正确的 Project、Filter、JQL、Sprint 或 Epic。
  4. 同一用户在 Jira 中是否能看到该范围的工作项。
  5. Work item date range 是否排除了数据。
  6. Trim History 是否排除了相关历史。
  7. 表格筛选和隐藏列是否影响结果。
  8. 时长报表的 Format、Calendar、时区和工作时间是否正确。

没有数据返回

所选设置没有找到工作项或可用报表值。

请检查：

  • 所选 Project、Filter、JQL、Sprint 或 Epic 在 Jira 中能返回工作项。
  • 当前用户可以查看这些工作项。
  • Work item date range 没有排除它们。
  • 表格筛选没有隐藏所有行。
  • Trim History 没有移除所有相关状态、负责人或流转历史。
  • 所选报表类型对这些工作项确实有数据。

JQL 错误

Jira 拒绝了 JQL，或当前用户没有匹配工作项。

检查语法、引号、字段名、项目 key 和取值；同时确认同一 JQL 在 Jira search 中可运行。

project = SR AND updated >= -30d ORDER BY updated DESC

如果查询中包含 ORDER BY，StatusPath Reports 在构建最终报表查询时可能应用自己的排序。

状态、负责人或流转缺失

动态列可能因为没有匹配历史或列被隐藏而不出现。

检查：

  • 所选工作项是否真的进入过该状态、负责人或流转。
  • Columns Manager 中是否选中了该列。
  • 报表类型是否支持该列类型。
  • Trim History 是否排除了相关片段。
  • 工作流状态名称是否与预期不同。

如需使用可复现的范围和历史进行排查，请参阅为什么 Time in Status 报表缺少某个 Jira 状态列。

时长值不符合预期

时长结果取决于范围、历史窗口、Calendar、工作时间、时区和 Format。与其他工具比较时，请先对齐这些设置。

图表为空

先回到 Table view 检查是否有行和可用数值。图表为空常见原因包括：报表类型不支持图表、动态列不存在、日期过滤或表格筛选排除了数据。

导出问题

导出较慢

大范围导出需要加载完整结果并生成文件。可以先缩小范围或使用更具体的 JQL。

导出为空

检查当前表格是否为空，以及筛选、日期和 Trim History 是否移除了所有行。

列缺失

导出跟随当前列配置。请先在 Columns Manager 中显示需要导出的列。

下载未出现

检查浏览器下载拦截，或尝试重新运行较小范围。

已保存报表问题

恢复后结果不同通常不是保存失败，而是 Jira 数据、权限、筛选器、字段、工作流或 Calendar 已变化。已保存报表保存配置，不保存结果快照。

Dashboard Gadget 问题

检查 dashboard 权限、gadget 配置、当前用户权限、范围设置和是否需要刷新 dashboard。必要时在主报表页面用相同设置重建报表，以便查看更详细的结果。

Average 参与项下探不可用

Issue 下探自 2.5 版本起在主报表页面提供。如果入口不可见，请确认 Jira 站点安装的是 StatusPath Reports 2.5 或更高版本。Average Time in Status 的入口位于“工作项数量”单元格；其他报表类型不提供该入口。

请先确认当前视图是 Average Time in Status 的 Table，并点击“工作项数量”旁的下探操作；平均时长单元格本身不会打开参与项列表。

如果明细提示下探数据不可用：

  • 重新运行当前报表以生成参与项快照。
  • 等待报表和分组计算完成后再打开。
  • 确认当前分组仍存在，且没有在打开明细前切换范围或报表类型。

Journey 无法加载

打开单个工作项 Journey 会重新读取该工作项的详情、完整 changelog 和工作流状态元数据。请检查：

  • 当前用户仍能查看该 Jira 工作项及其历史。
  • 工作项在报表生成后没有被删除或变得不可访问。
  • Jira 返回了可用的 changelog；没有状态历史时 Journey 无法构建路径。
  • 临时请求错误后使用“重试”或重新运行报表。

参与项仍出现在已生成列表中，不保证后来打开 Journey 时权限和 Jira 数据仍保持不变。

Journey 时长与报表行不同

先确认比较的是同一范围：

  • “报表范围贡献”或“所选分组贡献”卡使用当前报表及 Trim History 的计算边界。
  • “状态时间线”和“历史路径图”标记为完整历史，显示截至报表生成时刻的状态历史，当前不会按 Trim History 裁剪。
  • Calendar 和 Format 会影响两个区域的时长展示，但不会把完整 Journey 变成裁剪历史。

因此，不要用完整历史节点累计值直接验算裁剪后的报表值。详细边界见 Issue 下探。

流转人显示 Unknown user 或空白

流转人取决于 Jira 为状态变更事件返回的身份。用户已删除或不可用、隐私或权限边界，以及 changelog 缺少流转人数据，都可能显示 Unknown user。第一个状态时间线区间没有进入流转，因此可以显示 —。

Issue Activity 为空

Issue Activity 只读取当前工作项。“分析报表”取决于所选状态、负责人或流转数据。请确认当前用户有权限读取工作项及 changelog，并在工作项刚变更后使用顶部刷新操作。