发生了什么

平台会给商户一类“免时长”额度:在约定期限内,用户使用某项服务不收费,这段可以免费使用的时间按天记账。额度不是整块发下去的,商户每采购一批,系统里就留一条批次券,记着这批天数属于哪个商户、哪个城市、哪个套餐类目、配多少块电池,还剩多少天没有分配。商户在后台把天数分配给名下用户,分出去多少,就从名下额度里扣掉多少。

按什么方式扣,由扣减模式决定。这批商户用的是分配扣减模式:给用户分配天数时,系统直接从商户的额度里扣,所以分配前必须先算一遍这个商户还剩多少天,够才继续,不够就提示“批次可扣减天数不足”,分配不落库。

正常算法是:拿商户、城市、套餐类目、电池数这四个条件,把这个商户名下所有符合条件的批次券找出来,把剩余天数加起来,用这个合计数做校验。

这次不一样。商户在后台给用户修改免时长天数,页面提示“批次可扣减天数不足”,操作失败;而在业务台账上,这个商户的免时长剩余天数明显还有富余。记录没有写受影响的商户数、持续多久,只确认了在分配扣减模式下,会出现商户有余额却分配不了的结果。

本质

问题出在校验前查余额的条件上:代码把免时长套餐配置编号当成了这笔余额的归属键。

  1. 余额应当按业务维度汇总。一个商户的同类免时长可以来自多条批次券,只要商户、城市、套餐类目、电池数相同,它们就属于同一笔余额,少算任何一条,合计数都会变小。
  2. 代码用的却是免时长套餐配置编号。这个编号标识的是一份套餐配置,不是一批额度;正常情况下,一份配置一个编号,看起来足以区分商户名下的同类套餐。
  3. 可这个编号并不唯一。此前新增套餐配置时出现过并发写入,同一份配置在库里留下了多条记录,各自生成一个编号。于是同一商户、同一类免时长的批次券,被分挂在几个不同编号下。
  4. 余额查询只按其中一个编号过滤,只会带出挂在这个编号下的批次券。其他编号下的批次券不参与汇总,算出来的余额比实际少。
  5. 校验拿这个偏小的余额和要分配的天数比,判成天数不足,分配被拒绝。业务看到的提示是“批次可扣减天数不足”,真正的原因却是余额没有查全,而不是真的不够。

一个“一般情况下唯一”的内部编号,在历史并发写入的数据里并不唯一;按它算余额,只算到了其中一部分批次券。

记录里给了两层处理。临时做法是订正数据,把同一份套餐配置下各条批次券的编号统一成同一个,让余额查得全,业务先恢复。长期做法是改掉查询条件,按商户、城市、套餐类目、电池数四个维度汇总,记录写明这次改动在 1 月 29 日上线。上线后有没有逐笔核对“校验用余额”与批次券合计一致,记录里没有说明。代码为脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现。

错误代码

public interface FreeDurationBatchMapper {
    // 为什么错:余额只按“套餐配置编号”汇总,而同一份配置在历史并发写入后
    // 存在多个编号,挂在其编号下的批次券都被排除在外
    @Select("SELECT SUM(remain_days) FROM free_duration_batch WHERE config_id = #{configId}")
    Integer sumRemainByConfigId(@Param("configId") Long configId);
}

public class FreeDurationAllocService {

    /** 分配扣减模式:给用户分配天数前,先查商户剩余额度做校验 */
    public void allocate(Long configId, Long userId, int days) {
        Integer remain = batchMapper.sumRemainByConfigId(configId);
        if (remain == null || remain < days) {
            // 为什么错:拿到的是部分批次券的合计,却当成商户全部余额,直接判成不足
            throw new BizException("批次可扣减天数不足");
        }
        batchMapper.deductByConfigId(configId, days);
        userQuotaMapper.addDays(userId, days);
    }
}

修复代码示例

public interface FreeDurationBatchMapper {
    // 按商户、城市、套餐类目、电池数汇总,商户同类免时长的全部批次券都参与
    @Select("SELECT SUM(remain_days) FROM free_duration_batch " +
            "WHERE merchant_id = #{merchantId} AND city_id = #{cityId} " +
            "  AND category_id = #{categoryId} AND battery_count = #{batteryCount}")
    Integer sumRemain(@Param("merchantId") Long merchantId,
                      @Param("cityId") Long cityId,
                      @Param("categoryId") Long categoryId,
                      @Param("batteryCount") int batteryCount);
}

public class FreeDurationAllocService {

    /** 校验和扣减用同一组业务维度,两边算的必须是同一笔余额 */
    public void allocate(AllocCommand cmd) {
        int remain = batchMapper.sumRemain(cmd.getMerchantId(), cmd.getCityId(),
                cmd.getCategoryId(), cmd.getBatteryCount());
        if (remain < cmd.getDays()) {
            throw new BizException("批次可扣减天数不足");
        }
        // 扣减沿用同一组条件,不再依赖某一个配置编号
        batchMapper.deductByScope(cmd);
        userQuotaMapper.addDays(cmd.getUserId(), cmd.getDays());
    }
}

下次遇到这些场景要警惕

  • 给“余额够不够”这类校验写查询时:先列出这笔余额由哪几个业务维度决定,再故意用一个维度不全的条件跑一次,把查询结果和各批次券剩余天数的合计摆在一起看,确认会不会少算。
  • 准备把某个字段当唯一键用之前:先在这个字段上做一次重复检查,按它分组看有没有计数大于 1 的行,尤其要查历史上出现过并发写入、批量导入或复制配置的表。
  • 遇到“余额充足却提示不足”的反馈:不要先怀疑额度被别处占用,先把校验查询返回的余额和台账合计对比,看差多少、差在哪些批次,再决定是改数据还是改查询。
  • 统一编号或用改数据止血之后:按同一商户再走一次完整分配,确认校验余额等于全部批次券剩余天数之和,并且分配后两边同步减少,避免只让这一笔通过。