Camunda异步删除流程实例API调用后实例数未减少问题

你调用的POST /engine-rest/process-instance/delete是Camunda 7.x版本提供的异步批量删除接口，接口返回成功仅代表批量删除任务已被引擎接收创建，不代表流程实例已经完成实际删除——这是你看到接口响应正常，但流程实例统计数量没有下降的最常见原因。

• 先校验接口返回值
  这个接口正常响应会返回批量任务（Batch）的元信息，其中id字段是该异步删除任务的唯一标识。你当前的代码直接返回响应结果，没有对任务状态做后续校验，无法感知删除任务的实际执行进度。
• 跟进异步任务执行状态
  拿到返回的batchId后，需要轮询GET /engine-rest/batch/{batchId}接口查询任务进度，当返回结果中remainingJobs计数为0、且suspended字段为false时，才代表所有待删除的流程实例已经处理完成。
• 核对统计口径
  该接口仅删除运行时的流程实例记录，不会同步删除历史流程实例数据。如果你统计的实例数包含历史表中的实例记录，需要额外调用历史实例删除接口POST /engine-rest/history/process-instance/delete，或配置Camunda的历史数据清理规则自动清理。
• 检查参数配置影响
  你当前传入了skipSubprocesses: true参数，开启后仅会删除你传入ID对应的主流程实例，关联的子流程实例不会被纳入删除范围，如果统计范围包含子流程实例，也会出现计数未达预期的情况。
• 确认引擎Job执行器状态
  所有异步批量操作都依赖Camunda内置的Job执行器调度执行，如果引擎配置中关闭了Job执行器，所有批量删除任务会一直卡在待执行状态，不会触发实际删除逻辑。你可以直接查询引擎库的ACT_RU_JOB表，如果存在关联对应batchId的删除任务、且RETRIES_字段值正常但长期未执行，基本可以判定是Job执行器未正常启动。

你原有代码的请求URI缺少http://协议前缀，会导致request库解析地址异常，同时缺少异步任务状态跟进逻辑，修正后的可运行参考代码如下：

const request = require('request-promise-native');

async function batchDeleteProcessInstances(processInstanceIds, headers) {
  const createTaskOptions = {
    method: 'POST',
    uri: 'http://localhost:8080/engine-rest/process-instance/delete',
    headers,
    body: {
      processInstanceIds,
      deleteReason: "Removed Process Instances via Script",
      skipCustomListeners: true,
      skipSubprocesses: true,
    },
    json: true
  };

  try {
    // 提交异步删除任务
    const batchTask = await request(createTaskOptions);
    const batchId = batchTask.id;
    console.log(`批量删除任务已创建，任务ID：${batchId}`);

    // 每2秒轮询一次任务状态，直到任务执行完成/挂起
    let taskStatus;
    do {
      await new Promise(resolve => setTimeout(resolve, 2000));
      taskStatus = await request({
        method: 'GET',
        uri: `http://localhost:8080/engine-rest/batch/${batchId}`,
        headers,
        json: true
      });
      console.log(`当前剩余待删除实例数：${taskStatus.remainingJobs}`);
    } while (taskStatus.remainingJobs > 0 && !taskStatus.suspended);

    if (taskStatus.suspended) {
      throw new Error(`批量删除任务${batchId}已被挂起，请查看引擎服务端日志排查异常`);
    }

    console.log("流程实例批量删除执行完成");
    return taskStatus;
  } catch (err) {
    console.error("删除流程实例失败：", err);
    throw err;
  }
}

如果你需要同步删除流程实例、不需要异步批量能力，不要调用上述批量接口，单实例同步删除可以直接调用DELETE /engine-rest/process-instance/{processInstanceId}接口，该接口返回成功时实例已经完成实际删除，不会有异步等待的问题。

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