问题排查
翻訳準備中このガイドは現在、簡体字中国語版のみ提供しています。翻訳版は今後追加されます。
排查流程问题时，先记录应用、版本、环境、Task Type Key、Task Key 和当前用户。不要把 DEV 的设计状态与 TEST/PROD 的发布状态混在一起判断。
1. 快速定位表
| 现象 | 优先检查 |
|---|---|
| 编辑按钮禁用 | 当前版本是否为 DEVELOPING |
| 字段不在表单候选中 | 字段是否保存、版本是否一致、字段能力是否支持 |
| 运行态表单为空 | Task Type/节点是否绑定正确 Form，字段是否 Hidden |
| 任务没有处理人 | 节点处理人规则、角色成员、部门负责人、字段值 |
| 能查看但不能办理 | Work on Task 权限、当前 Assignee、节点操作 |
| TaskList 没有数据 | Filter Key、TQL、环境、权限、任务状态 |
| TQL 提示未知字段 | 使用补齐重新选择；检查自定义字段搜索能力 |
| TEST 看不到最新修改 | 是否完成保存与发布，TEST 当前版本是否正确 |
| 网关没有离开路径 | 条件覆盖、字段类型、空值和默认分支 |
2. 字段无法添加到表单
- 确认当前打开的是任务 Form Designer。
- 确认字段已在当前版本保存。
- 检查系统字段是否允许当前操作。
- 刷新表单字段库并重新选择。
- 检查版本是否只读。
如果问题只发生在 Page Designer，确认使用的是 Task Form，而不是 Business Object 的 Data Form。
3. 表单运行时显示错误
- 检查 Task Type 的 Create/View/Edit Form。
- 检查工作流节点操作绑定的 Custom Form。
- 检查 Hidden、Read Only、Required 和 Show When Empty（空值时显示）。
- 检查当前用户权限和当前任务状态。
- 检查目标环境是否已发布最新表单。
4. 任务没有处理人
按顺序检查：
- 任务当前 Step 是否正确。
- Human Activity 是否配置处理人来源。
- Applicant Department 或 User 字段是否有值。
- 部门是否有负责人。
- Finance Approver 等角色是否有有效成员。
- 多候选人策略是否要求先认领。
- 是否配置无候选人兜底。
images/pd-troubleshooting-assignee-01.webp5. TQL 或 Filter 无结果
先在 TQL 编辑器中通过语法和语义校验，再逐步缩短查询：
taskType = "PURCHASE"
确认有结果后增加状态：
taskType = "PURCHASE" AND status = "OPEN"
最后增加当前用户和排序。每增加一段就验证一次。即使 TQL 匹配，权限仍可能过滤结果。
6. 流程停在网关或错误节点
- 检查节点连线方向。
- 检查 Exclusive Gateway 是否误用为 Parallel。
- 检查金额字段是 Number，不是字符串。
- 检查 Amount 为空时的路径。
- 检查阈值边界，例如等于阈值属于哪条分支。
- 确认默认路径不会掩盖配置错误。
7. 权限问题
以两层检查：
- 数据可见性：用户是否有 View。
- 动作权限：用户是否有 Work on Task、Assign、Transfer、Edit 等对应 Permission Item。
前端按钮是否显示只是结果，不是权限来源。使用直接请求或详情 URL 验证服务端确实拒绝未授权操作。
8. 版本与发布问题
确认以下四个值：
- 当前设计版本
- 版本状态
- 当前运行环境
- 该环境的活动发布版本
保存只是保存草稿；TEST 和 PROD 必须执行发布。回滚后也需要核对活动发布记录和在途任务兼容性。
9. 提交问题所需信息
无法自行解决时，提供：
- 应用 ID、Version ID、环境
- Task Type Key 和 Task Key（如已有运行任务）
- 当前 Step 和操作名称
- 当前用户身份及预期权限
- 复现步骤、时间和完整错误信息
- 已脱敏的截图或网络请求响应
不要在截图、日志或问题描述中提交 access token、密码、附件存储密钥或用户隐私数据。