发生了什么

网点是平台在线下经营的点位,电柜要摆进网点才能对外提供换电服务。网点上线前必须签一份合同,合同在系统里对应一条记录,下面叫合同主记录,网点的绑定和查看都以它为依据。

正常流程是:网点先签合同,合同生效后,运营在后台把这个网点绑定电柜,再打开网点信息核对资料。合同要改条款时,不是直接改原合同,而是发起一次合同变更,变更流程按新条款再生成一条合同主记录,旧记录相应收口,让一个网点始终保持一份生效中的合同。

这次出问题的网点本来已经有一份生效中的合同,运营又在网点侧发起了一次合同变更。发起前的那个前置流程没有检查这个网点是否已有生效中的合同,直接放行;变更流程于是又生成了一条合同主记录,旧记录也没有被处理掉。同一个网点名下,就这样留了两条合同主记录。

随后在后台给这个网点绑定电柜时报错;打开网点信息,同样报错,页面弹出的提示还是一段看不懂的乱码。两处卡在同一个前提上:系统要按网点取它的合同,取出来不止一条,程序没法判断该用哪一条。处理方式是与业务确认后删掉无效的那份合同,只留一条;删完绑定是否恢复,材料里没有写。

本质

一句话:发起合同变更前的流程漏掉了“这个网点已有生效中的合同”这项判断,变更流程又新建了一条主记录,同一个网点出现两条合同记录;下游按网点取合同时拿到不止一条,绑定电柜和查看网点信息都失败。

  1. 原流程该判断什么。合同变更的入口在网点侧,发起前有一段前置流程负责判断这次变更能不能发起。判断里缺的正是这一项:该网点当前是否已有生效中的合同。
  2. 变更流程照常新建。变更不是改原记录,而是按新条款再插入一条合同主记录;发起前没被拦下,旧记录继续生效,新记录也写进来。
  3. 一个网点两条记录。从这一刻起,这个网点名下同时存在两条合同主记录。
  4. 下游按网点取合同。绑定电柜和查看网点信息,都要按网点读出它的合同;这两处默认一个网点只有一条,读到两条时无法判断用哪一条,直接报错。
  5. 页面只给乱码。提示是一段乱码,操作人看不出是合同重复,也不知道该找谁处理,只能在沟通群里问。
  6. 处理方式。短期是人工删掉无效的那条合同,这是数据订正,不是机制修复;长期是在网点侧的前置流程里加限制,不允许对已有生效合同的网点再发起变更。记录写明这个限制已上线、处于灰度中,灰度范围和验证结果材料里没有。

只删掉一条记录,下一次同样的变更还会再生成一条主记录:真正要补的是发起变更前的那道判断。

错误代码

// 网点合同变更与网点合同查询(脱敏教学示例)
class NodeContractService {

    // 为什么错:发起变更前没有查这个网点是否已有生效中的合同,
    // 原合同仍在生效时又插入一条主记录,一个网点就有了两条
    void startChange(long nodeId, ContractChangeRequest req) {
        ContractMain main = new ContractMain();
        main.setId(idGenerator.next());
        main.setNodeId(nodeId);
        main.setStartDate(req.getStartDate());
        main.setEndDate(req.getEndDate());
        main.setState("EFFECTIVE");
        contractMapper.insert(main);
    }

    // 为什么错:按网点取合同,默认一个网点只有一条;
    // 库里出现第二条时 selectOne 直接抛异常,绑定电柜、查看网点信息一起失败
    ContractMain currentContract(long nodeId) {
        return contractMapper.selectOne(new QueryWrapper<ContractMain>()
                .eq("node_id", nodeId));
    }
}

修复代码示例

// 修复:发起变更前先确认该网点没有生效中的合同,存量重复记录另行清理(脱敏教学示例)
class NodeContractService {

    void startChange(long nodeId, ContractChangeRequest req) {
        // 修复一:把「已有生效中的合同」作为发起变更的前置条件
        List<ContractMain> inEffect = contractMapper.selectList(
                new QueryWrapper<ContractMain>()
                        .eq("node_id", nodeId)
                        .eq("state", "EFFECTIVE"));
        if (!inEffect.isEmpty()) {
            throw new BizException("网点已有生效中的合同,请先处理原合同再发起变更");
        }
        ContractMain main = new ContractMain();
        main.setNodeId(nodeId);
        main.setStartDate(req.getStartDate());
        main.setEndDate(req.getEndDate());
        main.setState("EFFECTIVE");
        contractMapper.insert(main);
    }

    // 修复二:清理存量前先按网点统计,列出合同主记录超过一条的网点
    List<NodeContractCount> findDuplicateNodes() {
        return contractMapper.countContractsByNode(); // 只返回 count > 1 的网点
    }
}

两段代码对应同一处缺口:错误版在发起变更时不看这个网点已有几份合同,读合同的地方又假定只有一条;修复版把“已有生效中的合同”挡在发起之前,并把存量重复网点先列出来人工确认。删除无效合同是这次的数据订正,没有写成代码里的自动动作;上线的是前置流程里的限制,处于灰度中,覆盖范围和验证结果待确认。

代码为脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现;类名、方法名、字段名和提示文案均为示意。

下次遇到这些场景要警惕

  • 给合同变更加入口时:先拿一个已有生效合同的网点走一遍变更,再去后台做绑定和查网点信息,确认变更后该网点名下只有一条合同主记录。
  • 变更流程新建主记录之前:查清它以哪份合同为基准、旧记录由谁收口;如果代码里没有“处理旧记录”这一步,就先按网点统计合同条数,看会不会出现两条。
  • 看到“按网点取合同”的查询时:确认它是否假定只有一个结果;用两条记录造一次数据,观察是取第一条、报错还是返回空,报错时页面提示能不能看懂。
  • 修完反馈的这一条之后:按网点分组统计合同主记录数,把所有大于一条的网点列出来批量确认,而不是只处理被反馈的那一个。