发生了什么

商户是入驻平台后可以开展经营的主体,一条商户记录代表一家商户,记录上有三个关键字段:是否启用、审批状态、最终审批状态。商户入驻审核通过后,系统还要在审批平台上发起一条审批流,由审批人处理;审批平台处理完会回调内部程序,内部程序按商户把审批状态改成“已通过”。商户列表页面展示的就是这个审批状态,未结束显示“审批中”,通过后显示“已通过”。下游业务判断一家商户能不能经营,只看是否启用,不看审批状态。

这条链路要求先落状态、再发起审批流:审核通过后写商户记录,把审批状态记成“审批中”,然后发起审批流;审批结束回调回来,状态推进到“已通过”,列表显示也随之更新。

这一次,值班收到反馈:有商户的审批状态一直停在“审批中”,但打开审批平台却找不到任何待处理的审批流。排查确认不是回调丢了,而是回调来早了。审批很快结束,回调先把商户的审批状态改成“已通过”,随后主流程才执行收尾的那次更新,又把“审批中”写了回去。两个写入方先后改同一条商户记录,后写的那个拿着更早的状态意图,把已经正确的终态盖掉了。该商户已经启用并在正常经营,业务链路没有受到影响,问题只体现在列表展示:商户看起来还在审批,实际流程早已结束,也不会再有新的回调来改写它。

记录里给出的处理是把这家商户的审批状态和最终审批状态直接改成“已通过”,让列表不再显示“审批中”。这是数据订正,不是对代码缺陷的修复。

本质

同一条商户记录上有两个写入方,其中一个用的是过时的状态值。

  1. 商户入驻处理程序在审核通过后落商户记录,但审批状态这一步放在了发起审批流之后,落库时这个字段还是空的。
  2. 处理程序调用审批平台发起审批流,拿到流程实例号。
  3. 这次审批很快走完,平台的回调先到。回调程序按商户标识查出记录,把审批状态和最终审批状态改成“已通过”。
  4. 主流程这时才执行后置更新,把流程实例号和“审批中”一起写回同一条记录。这条更新只覆盖传入的非空字段,又不带“当前状态是否已是终态”的条件,于是第 3 步写进去的“已通过”被改回“审批中”。
  5. 审批实例已经结束,不会再有回调。状态永久停在“审批中”,而审批平台里查不到待办任务,两边对不上。

一句话:这条记录的终态只能靠回调推进,但主流程的收尾更新可以把已经推进的终态拉回中间态,而且没有任何条件拦住它。修复方向是反过来:先把“审批中”落库,再发起审批流,让回调不可能早于状态写入;收尾更新只补流程实例号,不碰审批状态;状态写入再加条件,只有当前仍是待审批时才允许改成“审批中”,已是终态就直接跳过。修复上线与验证情况,记录没有说明。

错误代码

/** 商户入驻审核通过后的处理:先发起审批流,再回写状态 */
public void onEntryApproved(MerchantEntryContext ctx) {
    Merchant merchant = buildMerchant(ctx);
    merchant.setEnable(true);                       // 下游业务只读这个字段
    merchantMapper.insert(merchant);                // 此刻审批状态还是空的

    String instanceId = workflowClient.start(...);  // ① 先发起审批流
    merchant.setApprovalInstanceId(instanceId);
    merchant.setApprovalStatus(APPROVING);
    merchant.setFinalApprovalStatus(APPROVING);
    // 为什么错:这次局部更新把状态一起带上,且不判断当前值;
    // 审批很快结束、回调已经写入“已通过”时,这里会把它覆盖回“审批中”
    merchantMapper.updateSelective(merchant);
}

/** 审批平台的回调:把结果写回商户 */
public void onWorkflowCallback(WorkflowCallback callback) {
    Merchant update = new Merchant();
    update.setId(callback.getBizId());
    update.setApprovalStatus(callback.isPassed() ? APPROVED : REJECTED);
    update.setFinalApprovalStatus(update.getApprovalStatus());
    // 回调本身没问题,问题在于它可能比主流程的收尾更新更早执行
    merchantMapper.updateSelective(update);
}

修复代码示例

/** 商户入驻审核通过后的处理:先落状态,再发起审批流 */
public void onEntryApproved(MerchantEntryContext ctx) {
    Merchant merchant = buildMerchant(ctx);
    merchant.setEnable(true);
    merchant.setApprovalStatus(APPROVING);          // 先把“审批中”落库
    merchant.setFinalApprovalStatus(APPROVING);
    merchantMapper.insert(merchant);

    String instanceId = workflowClient.start(...);  // 再发起审批流,回调不会早于状态
    // 收尾只补流程实例号,不碰审批状态
    merchantMapper.updateInstanceId(merchant.getId(), instanceId);
}

/** 兜底:状态写入带条件,当前已是终态就不再覆盖 */
public int markApproving(Long merchantId) {
    // 只有当前仍是待审批时才允许改成“审批中”,迟到的写入自动失效
    return merchantMapper.updateStatusIfCurrent(
            merchantId, PENDING_APPROVAL, APPROVING);
}

两段代码是脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现。

下次遇到这些场景要警惕

  • 在业务主流程里发起外部审批或工作流:先确认本地状态已经落库,再发起。构造一次“回调立刻返回”的场景,比如测试审批流或自动通过规则,跑完检查终态有没有被后面的更新改回中间态。
  • 给记录加一次后置更新:先列出这条记录还有哪些写入方,包括回调、定时任务和人工订正;确认每条更新都带状态条件或只写明确字段,不要拿整个对象做局部更新。
  • 看到“状态停在中间态、外部却没有待办”的反馈:先查外部实例的最终状态,再查本地状态最后一次被谁在什么时间改成什么,不要先去重放回调;本例重放也没用,实例已经结束。
  • 用接口订正状态数据:先和业务确认下游读的是哪个字段,本例只读是否启用;订正只改展示字段时要说清它不修代码,避免被当成问题已经解决。