发生了什么

商户和平台合作要签合同,合同签完之后在系统里走归档:状态从签署中变成已归档,表示这份合同正式生效、后续按它执行。归档之后还有一步业务动作——系统要按合同内容发起一笔分润规则审批流,审批走完,分润规则才生效、对应账号才能按这份合同启用。这一步不需要人点,是系统自动发起的。

正常流程是这样:合同程序把“合同已归档”写成一条消息,消息里带合同编号、商户编号和用到的合同模板;一个专门消费这条消息的程序收到后,判断这条消息该走哪套处理,再由老流程把分润规则审批流创建出来,审批人在后台待办里就能看到。

6月11日上线了一条新的合作档案处理流程。新流程在消费入口加了一条优先级更高的分流条件:只要合同模板在模板配置表里的状态是“已完成”、模板编号又能对上,这条归档消息就直接交给新流程,老流程不再执行。

这次出问题的合同正好命中。归档消息被分到新流程,新流程要先按商户编号查合作档案表,拿到这个商户的档案记录才继续同步这笔合同。合作档案是这次新做的数据,只覆盖新签约的商户;6月11日之前已经在合作的存量商户没有档案记录,查询结果为空。新流程在这个空结果上直接返回:没有退回老流程,没有抛错,也没有留下告警。消息被当成处理成功消费掉,分润规则审批流始终没有创建。

影响多少商户、持续多久,记录里没有统计。能确认的是这条合同归档后应有的审批没有发起,业务在反馈里问的正是这件事:合同已经归档,为什么没有把账号启用的审批推出去。

本质

一句话:新流程凭“模板对得上”就接管了归档消息,但它依赖的商户档案对存量商户并不存在,查到空又直接返回,老流程被整段短路,审批流没人发起。

  1. 老流程的职责是收到归档消息后,为这份合同发起分润规则审批流。它不查合作档案表,也不依赖档案数据。
  2. 新流程处理的是合作档案:先按商户编号查档案,查到才继续同步合同信息。也就是说,合作档案是它处理这笔业务的前提,没有档案就没有可操作的对象。
  3. 分流条件只检查了模板是否“已完成”、编号是否匹配,没有检查这个商户有没有档案。存量商户的档案没有铺,条件照样成立,消息被分走。
  4. 新流程查档案为空后直接 return。在消息消费这一层看,返回就是处理完成,消息被确认,老流程不会再收到同一条消息。
  5. 于是合同归档成功、合同状态正常,唯独审批流没有生成。跳过既不报错也不告警,从消息积压、消费失败这些指标上都看不出来。

新增的分流只证明了“模板对得上”,没有证明“新流程处理得了”,却已经把老流程挡在了外面。

记录给出的处置是临时的:把线上一张测试用的合同模板逻辑删除,让归档消息不再命中新流程的分流条件,再重新发送合同回调消息,让这条合同重走一遍老流程。代码侧有没有补回退和告警,记录没有说明。修复方向是:分流前先判断新流程能不能处理这笔业务,档案不存在就不接管、交回老流程;新流程真正处理失败时要抛错并告警,不能用空返回把失败吞掉。

下面的 Java 代码为脱敏教学示例,用于说明“新流程抢先分流、查空静默返回”的机制与改法,不代表实际项目源码或已上线实现,类名、表名、状态值均为示意。

错误代码

// 合同状态变更消息的消费入口:按模板决定交给新流程还是老流程(示意)
public void onMessage(ContractStatusEvent event) {
    ContractTemplate tpl = templateRepo.get(event.getTemplateId());
    if (tpl != null && "COMPLETED".equals(tpl.getStatus())) {
        // 为什么错:只看模板是否已完成就把消息交给新流程,
        // 没有确认这个商户有没有档案,老流程被整段跳过
        archiveSyncService.handleSignCallback(event);
        return;
    }
    oldFlow.handle(event);   // 老流程:为这份合同发起分润规则审批流
}

// 新流程:基于商户的合作档案同步这笔合同
public void handleSignCallback(ContractStatusEvent event) {
    CoopArchive archive = archiveRepo.getByMerchantNo(event.getMerchantNo());
    if (archive == null) {
        // 为什么错:存量商户没有档案,查到空直接返回,
        // 既不回退老流程,也不抛错、不告警,消息被当作处理成功
        return;
    }
    archive.setContractStatus(event.getStatus());
    archiveRepo.update(archive);
}

修复代码示例

public void onMessage(ContractStatusEvent event) {
    ContractTemplate tpl = templateRepo.get(event.getTemplateId());
    // 改:分流前先问新流程能不能处理这笔业务,不再只看模板
    if (tpl != null && "COMPLETED".equals(tpl.getStatus())
            && archiveSyncService.canHandle(event.getMerchantNo())) {
        archiveSyncService.handleSignCallback(event);
        return;
    }
    // 改:新流程处理不了(含存量商户没有档案)时仍走老流程,审批照常发起
    oldFlow.handle(event);
}

public void handleSignCallback(ContractStatusEvent event) {
    CoopArchive archive = archiveRepo.getByMerchantNo(event.getMerchantNo());
    if (archive == null) {
        // 改:确有必要走新流程却查不到档案时抛错并告警,交给消费重试,
        // 不再用空返回把失败吞掉
        throw new IllegalStateException("合同归档同步失败,缺少合作档案: " + event.getContractNo());
    }
    archive.setContractStatus(event.getStatus());
    archiveRepo.update(archive);
}

下次遇到这些场景要警惕

  • 给消息消费加一条新的分流条件时:先写下新流程处理一笔业务需要哪些数据,再逐条核对这些数据对存量对象是否都成立;只要有一条不成立,分流条件里就要包含它,否则老流程会被短路。
  • 新流程依赖一张新建的表或新增的档案数据时:用存量商户、存量合同各构造一笔跑一遍消费,观察新流程走不通时有没有回到老流程;不要只用新签约的商户验证。
  • 新老两套处理并存期间:给“新流程跳过”单独记一条日志并计数,告警盯这个数;只看消费失败率,静默返回永远发现不了。
  • 临时处置是删配置、改模板、重发消息时:重发前确认这条消息重走的是老流程,并核对审批流是否真的创建出来;删除只能让这一条合同绕过问题,代码里缺的回退和告警还在。