企业微信二次开发：业务执行过程中断后，如何从上一步继续处理

在企业微信二次开发中，一个业务请求可能需要经过多个处理环节。

比如客户在外部群提交订单申请，系统需要先查询客户信息，再创建订单，最后同步库存。如果执行到一半出现网络异常或服务重启，任务就可能中断。

这时候如果从头执行，容易造成重复创建订单、重复调用接口等问题。

使用星云API对接企业微信消息时，可以结合任务状态记录和断点续执行机制，让中断的业务从未完成的步骤继续处理。

一、将业务拆分为独立步骤

假设一个订单业务需要经过三个环节：

1. 查询客户信息

2. 创建订单

3. 同步库存

每完成一个步骤，就保存对应的执行状态和返回结果。

步骤	执行状态
查询客户信息	SUCCESS
创建订单	SUCCESS
同步库存	FAILED

当任务恢复时，就可以根据已保存的状态，跳过前两个步骤，继续处理库存同步。

二、记录任务执行进度

可以为每个业务请求生成唯一任务ID，并记录当前处理步骤。

例如：

{
  "taskId": "TASK1001",
  "customerId": "USER001",
  "currentStep": "sync_inventory",
  "status": "INTERRUPTED",
  "completedSteps": [
    "get_customer",
    "create_order"
  ]
}

需要注意，除了保存步骤状态，还应该记录订单编号等关键业务结果，方便后续步骤继续使用。

三、设计断点恢复流程

客户发送企业微信消息
        ↓
创建业务任务
        ↓
查询客户信息 → 完成并保存
        ↓
创建订单 → 完成并保存
        ↓
同步库存 → 执行中断
        ↓
记录异常及任务状态
        ↓
恢复任务执行
        ↓
读取已完成步骤
        ↓
检查库存同步实际结果
        ↓
继续执行未完成操作
        ↓
更新任务最终状态
        ↓
回复客户处理结果

恢复任务时，不能只根据本地步骤状态直接重新调用接口。如果上一次请求已经到达第三方系统，需要先确认实际执行结果。

四、实际开发需要注意的问题

1. 每个步骤独立保存状态

不要等全部业务执行完成后才写入数据库。关键步骤完成后，应及时保存状态和返回数据。

2. 做好接口幂等控制

例如订单创建接口，即使任务恢复后再次调用，也应该通过唯一业务请求ID避免重复创建。

3. 设置失败重试机制

对于临时网络异常，可以设置有限次数的自动重试。对于参数错误、权限不足等问题，则需要修正后再继续。

4. 防止多个任务同时恢复

可以通过数据库锁或任务租约控制执行权，避免多个后台服务同时恢复同一个任务。

5. 保存异常执行记录

记录中断时间、失败步骤、错误原因和恢复次数，方便后续排查。

五、任务恢复后如何通知客户

任务恢复期间，可以根据实际情况向客户发送处理状态。

例如：

任务编号：TASK1001
当前状态：继续处理中
已完成：客户查询、订单创建
正在处理：库存同步

任务最终完成后，再通过企业微信 API 将处理结果推送到对应客户或群聊。

六、总结

企业微信二次开发中的断点续执行，核心是记录每个业务步骤的执行结果，而不是简单地在异常后重新执行整个任务。

通过任务ID、步骤状态持久化、幂等控制和失败恢复机制，可以减少重复操作，提高复杂业务的执行稳定性。

使用星云API对接企业微信消息收发能力，再结合数据库和后台任务队列，可以实现业务中断后的状态恢复与结果反馈。

相关接口参考顶部星云官网卡片里的接口文档。