禅道缺陷状态流转异常如何排查？

Question

禅道缺陷状态流转异常如何排查？一个常见问题是：在禅道系统中，缺陷状态无法从“激活”流转至“已解决”，点击操作无响应或提示权限不足。该问题通常由角色权限配置错误、工作流自定义规则冲突或数据库字段约束异常导致。需检查用户所属分组的权限设置、确认“已解决”状态的触发条件是否满足，并核查zt_action表中相关操作日志。此外，浏览器缓存或JS脚本加载不全也可能引发前端交互失效，需结合F12控制台与后端日志综合分析。

Answer 1

一、禅道缺陷状态流转异常排查：从表象到根源的系统性分析

在企业级项目管理平台中，禅道（Zentao）作为国产开源ALM工具，广泛应用于研发流程管理。然而，在实际使用过程中，“缺陷状态无法从‘激活’流转至‘已解决’”是高频出现的问题之一。该问题不仅影响开发闭环效率，也可能暴露权限体系或数据一致性层面的深层隐患。

1. 问题现象与初步定位

• 用户点击“解决”按钮无响应；
• 弹出提示“权限不足”或“操作失败”；
• 页面刷新后状态未变更；
• F12开发者工具中发现JS报错或AJAX请求403/500错误。

此类问题首先需区分是前端交互异常还是后端逻辑阻断，建议通过浏览器控制台（F12）查看Network和Console面板输出信息。

2. 权限配置层级排查

禅道基于RBAC模型进行权限控制，状态流转受用户所属分组及角色策略约束。

分组名称	典型权限	是否可修改缺陷状态	对应模块设置路径
开发人员	bug-edit	是	/admin-permission-group-view-id_xxx
测试人员	bug-resolve	否（默认）	/admin-permission-group-view-id_xxx
项目经理	bug-all	是	/admin-permission-group-view-id_xxx
访客	read-only	否	/admin-permission-group-view-id_xxx

检查当前用户所属分组是否具备bug-resolve或bug-edit权限，并确认其所在项目的权限继承关系。

3. 工作流规则与自定义字段校验冲突

当系统启用了自定义工作流或必填字段规则时，可能导致状态流转被拦截。

// 示例：zentao/module/bug/control.php 中的状态转移逻辑片段
if ($this->post->resolvedBuild == '') {
    dao::$errors['resolvedBuild'][] = '请选择解决版本';
    $this->display();
    exit;
}
    

需核查以下配置项：

1. 缺陷表单中“解决版本”是否为必填项且未填写；
2. 是否存在自定义验证规则（如脚本钩子）返回false；
3. 工作流引擎中“激活 → 已解决”的转换条件是否满足（例如仅允许特定责任人执行）。

4. 数据库层状态约束与操作日志追踪

禅道使用zt_bug表存储缺陷主数据，zt_action记录操作流水。

SELECT * FROM zt_action 
WHERE objectID = [缺陷ID] AND objectType = 'bug' 
ORDER BY date DESC LIMIT 10;
    

重点关注action为activated、resolved的操作记录，判断是否有失败尝试。同时检查zt_bug表中status字段当前值与期望目标值的一致性。

5. 前端资源加载异常诊断

JavaScript脚本缺失或缓存污染会导致按钮事件绑定失败。

graph TD A[用户点击解决按钮] --> B{浏览器是否加载resolve.js?} B -- 否 --> C[清除缓存/强制刷新] B -- 是 --> D{是否触发$.ajax提交?} D -- 否 --> E[检查DOM事件监听] D -- 是 --> F[查看XHR响应码] F -- 403 --> G[服务端权限拒绝] F -- 500 --> H[PHP错误日志分析]

利用Chrome DevTools的Sources和Network标签页，验证关键JS文件（如/res/js/zentao/bug.js）是否完整加载。

6. 综合排查流程图与最佳实践

建立标准化故障树有助于快速定位根因。

1. 复现问题并抓取前端错误日志；
2. 确认用户身份与项目角色权限；
3. 检查缺陷详情页所有必填字段是否合规；
4. 审查自定义流程插件或扩展脚本；
5. 查询zt_action日志确认操作是否到达服务端；
6. 分析PHP错误日志（如runtime/logs/php.log）；
7. 对比正常环境与异常环境的数据库schema差异；
8. 临时切换至内置管理员账户测试权限隔离；
9. 更新禅道版本或应用补丁包修复已知BUG；
10. 启用debug模式获取更详细的trace信息。

对于高可用场景，建议结合Zabbix或ELK搭建日志监控体系，实现异常流转行为的实时告警。