发生了什么

换电业务里,用户要先交一笔押金,才能借用电池。交成功后,系统在用户名下登记一条“押金记录”,记录里带缴纳时间和状态;“生效中”表示这笔押金当前有效,退还或关闭后才结束。同一个用户在同一时间只应该有一条生效中的押金记录。

免套餐是另一类资格:商户在约定期限内免除用户的套餐费用,用一张“免套餐卡”表示。免套餐管理页用来查看某位用户的免套餐卡,页面上还会带出押金信息,数据取自那条生效中的押金记录。正常情况下只有一条,页面取这一条展示,流程是通的。

这一次,打开一位用户的免套餐管理页,整页直接落到通用错误提示“网络开小差了,请稍后重试”,免套餐卡和押金信息都看不到。排查后确认:这位用户名下同时存在两条生效中的押金记录。页面取押金数据时按“只有一条”的假设处理,既没有定义多出一条时取哪条,也没有兜底;查询返回两条后,这一步拿不到可展示的唯一结果,整页请求报错。

这两条记录是历史上缴纳押金的程序留下的:那条写入路径没有做并发控制,同一个用户的缴纳请求并发到达时各写入一条生效记录,之后都留在生效状态。

处理分两层。页面侧先做兼容:展示时不再假定只有一条,取缴纳时间最近的那条生效押金作为展示数据,保证页面能打开。长期做法是把用户侧所有押金插入入口集中到一处,对写入做并发控制,避免再产生新的重复押金;历史上已过期和重复的押金,计划按需求单独清理,具体规则还没有定。问题状态已标记为完成;兼容处理是否上线、历史数据是否清理,现有信息没有说明。

本质

一句话:写押金记录的一侧没有并发控制,同一用户被写入两条生效记录;读的一侧又假定只有一条,重复数据就让整页展示失败。

  1. 原流程。用户缴纳押金,押金程序在用户名下插入一条生效中的押金记录;页面展示时按用户取这条记录,正常渲染。
  2. 出错的一步在写入。缴纳链路对同一用户的并发写入没有任何拦截:写入前没有对这个用户加锁,数据库上也没有对“生效中的押金”加唯一约束。两个缴纳请求同时处理时,都认为自己可以写入,于是各插入一条生效记录。问题不在某一次请求的参数,而在这条写入路径允许并发写入,却没有让唯一性在并发下成立。
  3. 重复数据留下后不会自己消失:两条记录都处于生效中,之后按用户查押金都会读到两条;调用押金接口的程序也没有按“可能有多条”来设计。
  4. 出错的一步在读。页面把查询结果当成唯一一条,没有处理第二条的分支;同一个用户返回两条时,取数这一步拿不到唯一结果,异常向上抛出,整个页面请求失败,前端只剩通用错误提示。
  5. 所以页面报错只是最后一步。要补的是两端:写入端让唯一性在并发下成立,读取端对已有的重复数据有兜底。

“一个用户只有一条生效押金”不能只写在文档里:并发请求不会自动排队,没有锁或唯一约束兜底,写入路径每放开一次并发,就可能多留一条。

修复方向是两端一起改:写入侧把押金插入入口集中到同一处,用锁或唯一约束保证同一用户只有一条生效记录;读取侧取缴纳时间最近的一条,先让页面可用。历史数据是否清理、保留哪条、其余怎么处理,取决于后续规则,不能把页面兼容当成数据已修好。

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

错误代码

// 押金写入与页面取数(脱敏教学示例)
public class DepositService {
    public void pay(PayCommand cmd) {
        // 为什么错:先查有没有生效押金,再插入。
        // 查询与插入之间没有锁,表上也没有唯一约束,
        // 两个并发请求都会查到“没有”,各自插入一条
        if (depositMapper.countActive(cmd.getUserId()) > 0) {
            return;
        }
        depositMapper.insert(DepositDO.active(cmd.getUserId(), cmd.getAmount(), cmd.getPaidAt()));
    }
}

public class PackageCardPageService {
    public PackageCardView load(long userId) {
        // 为什么错:页面按“一个用户只有一条生效押金”取单条。
        // 历史重复数据让这里返回两条,取数直接失败,整页报错
        DepositDO deposit = depositMapper.selectActiveOne(userId);
        return PackageCardView.of(deposit);
    }
}

修复代码示例

// 修复:写入靠唯一约束兜底,读取兼容历史重复数据(脱敏教学示例)
public class DepositService {
    public void pay(PayCommand cmd) {
        try {
            // 修复:生效时 active_user_id 等于用户标识,关闭时置空;
            // 唯一索引让并发写入只有一条成功,另一条落到下面的分支
            depositMapper.insert(DepositDO.active(cmd.getUserId(), cmd.getAmount(), cmd.getPaidAt()));
        } catch (DuplicateKeyException e) {
            // 已有生效押金,本次按重复缴纳处理,不再新增记录
            log.info("duplicate active deposit, userId={}", cmd.getUserId());
        }
    }
}

public class PackageCardPageService {
    public PackageCardView load(long userId) {
        // 修复:读取侧不再假定唯一,取缴纳时间最近的一条展示,页面可打开
        DepositDO deposit = depositMapper.selectLatestActive(userId);
        return PackageCardView.of(deposit);
    }
}

两段代码改的是同一处:错误版把“一人一条生效押金”只当成约定,写入没有原子性保证;修复版假设表上已对生效标记建唯一索引,并发下只放行一条,读侧对旧数据取最近一条兜底。集中到同一入口是前提:唯一约束只能拦住第二条,各条写入路径要由同一处决定失败怎么处理。

下次遇到这些场景要警惕

  • 给“一个用户只能有一条生效记录”这类数据加写入路径时:列出所有会插入的位置,确认它们都走同一处并受同一个锁或唯一约束保护;用两个并发请求打同一个用户,检查最终只有一条生效记录。
  • 给这类表加唯一约束时:先确认约束范围只覆盖生效状态;再造一条已关闭记录加一条生效记录,验证关闭后还能重新写入,不会把正常的历史记录卡住。
  • 页面或接口读取这类记录时:按“可能有多条”来写兜底,取最近一条或明确报数据异常,不要直接取单条;用两条生效记录造一次数据,确认页面仍能打开。
  • 清理历史重复押金前:先统计有多少用户存在重复、重复记录处于什么状态,确认保留哪条、其余怎么关闭后再执行;清理只能处理存量,写入侧的并发控制仍然要做。