使用Alfresco REST API完成任务时排他网关分支报错求助

看起来你在开发基于REST API的Alfresco工作流管理应用时，卡在了排他网关的分支流转环节，我来帮你梳理几个常见的排查方向和解决方案：

一、先确认REST请求的变量传递是否合规 #

Alfresco的REST API对流程变量的格式有明确要求，你提交任务2时，必须确保decision变量以正确的结构传递。比如标准的请求体应该是这样的：

{
  "action": "complete",
  "variables": [
    {
      "name": "decision",
      "value": "approve",
      "type": "string"
    }
  ]
}

要注意这几个细节：

• 变量名decision必须和BPMN文件里的条件变量完全一致（大小写敏感）
• 必须显式指定type为string，否则Alfresco可能无法正确识别变量类型
• 确认请求发送到了正确的API端点，比如Alfresco内置Activiti引擎的任务完成端点通常是/activiti-rest/service/runtime/tasks/{taskId}/complete

二、检查BPMN文件里的排他网关条件表达式 #

虽然你提到分支条件是decision等于approve，但很可能是表达式语法出了问题。找到BPMN中flow22对应的sequenceFlow元素，核对条件表达式：

<sequenceFlow id="flow22" sourceRef="你的排他网关ID" targetRef="task3">
  <conditionExpression xsi:type="tFormalExpression">${decision == 'approve'}</conditionExpression>
</sequenceFlow>

这里要避免两个低级错误：

• 误把判断相等的==写成赋值运算符=，这会导致表达式执行时直接报错
• 变量名拼写错误（比如写成Decision而非decision），EL表达式对变量名大小写是敏感的

三、查看Alfresco日志定位具体错误 #

最直接的方式是打开Alfresco的服务器日志（比如tomcat/logs/catalina.out或者alfresco/logs/alfresco.log），找到任务完成时的错误堆栈信息。日志会明确告诉你是变量不存在、表达式语法错误，还是权限不足等具体问题，这能帮你快速锁定根源。

四、验证流程变量是否成功被设置 #

你可以调用Alfresco的REST API查询当前流程实例的变量列表，确认decision是否真的被设置为approve：

GET /activiti-rest/service/runtime/process-instances/{processInstanceId}/variables

如果返回结果里没有decision变量，或者值不符合预期，说明你的变量传递环节出了问题，需要重新检查请求体和API调用逻辑。

如果以上步骤都排查完还是无法解决，建议把完整的报错信息和BPMN文件里排他网关、任务2的完整代码片段贴出来，这样能更精准地帮你定位问题。

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