发生了什么
商户可以送给用户一段免费使用的时间,业务上叫「免时长」,按天记账。商户端应用里有一个「免时长分配」功能:客服选中用户、填好天数,再选城市和电池类目。同一个用户在不同城市、不同电池类目下可以各有一份额度,但同一份额度只应该有一条记录。
一次分配会落一条免时长套餐,状态先是「待激活」。用户真正开始使用、开启免押时,系统才从待激活的套餐里挑一条绑定并激活,这条套餐才算真正生效。后台的分配记录列表按套餐逐条展示,商户用它核对谁在什么时候、给谁分了多少天。
正常流程是:提交分配后,系统先做一次查重,看同一用户在同一商户下、城市和电池类目是否已经有套餐,有就拒绝这次分配,没有才创建套餐和分配记录。这一次的问题正出在这一步。两名客服同时为同一个用户操作「免时长分配」,两边的查重都读到「还没有套餐」,都通过了校验,随后各自创建了一条套餐。于是同一个商户下、同一个用户、城市和电池类目完全相同的两条分配记录,一起出现在列表里。
商户看到的就是这个结果,直接来问:同一用户在同一商户下,怎么会有两条城市和电池类目一样的分配记录。
影响要分清楚:这种重复不会让用户多拿额度,开启免押时只绑定并激活其中一条,另一条一直停在待激活,主流程没受影响,也没有资金损失。但记录层面确实多了一条:列表上多出一条分配,商户核对时会以为这个用户被分过两次,也难判断哪条才真正生效。记录给出的存量是 47 条,时间从 2022 年跨到 2025 年。
本质
一句话:查重和创建是分开的两步,两步之间既没有互斥,也没有唯一约束兜底;两名客服的请求都在这段缝里通过了校验,于是各建了一条套餐。
拆开看:
- 原流程完成了什么。一次分配先按用户、商户、城市、电池类目查一遍有没有套餐,查不到才插入套餐和分配记录,插入后套餐处于待激活。
- 并发时哪一步失效。查重是读,创建是写。两个请求同时在处理:第一个请求查完还没插入,第二个请求就查完了,两边读到的都是「没有」,于是都判定可以创建。校验本身没写错,它给出的只是「读取那一刻还没有」;这个结论在两次写入之间就过期了。
- 为什么没有东西拦住第二条。这条写入路径上没有对同一用户、同一维度加互斥,数据库上也没有对「同一维度只能有一条」加唯一约束,所以两条插入都会成功。
- 结果为什么看起来矛盾。两条套餐都停在待激活,列表按套餐逐条展示,就出现了两条城市和电池类目一致的分配记录;而激活只绑定一条,其余保持待激活:数据上重复,使用上只认一条。
- 现在的处置。当天下午先把重复生成的记录额度清零,再把对应的套餐状态关闭,把多出来的那条从待激活里摘出去;存量 47 条按同样口径处理。
查重通过只说明「读取的那一刻还没有」,并不保证「插入的那一刻仍然没有」;两个请求可以同时通过同一道校验。
长期修复方向是给这条链路加并发控制,让同一用户在同一维度下的套餐额度操作串行化;同时梳理「免时长、免套餐、免押金」这类资金相关写接口,统一补并发控制,并加每日巡检重复数据的定时任务,发现重复就告警。这些是否已经上线、存量清理是否完成,记录没有说明,不能把这次清零和关闭当作已经修好。
错误代码
public class FreeDurationService {
/** 给用户分配免时长:先查重,再创建套餐和分配记录 */
@Transactional
public void allocate(AllocateCommand cmd) {
// 为什么错:查重和插入是分开的两步,中间没有加锁,表上也没有唯一约束,
// 两个并发请求都会查到「没有」,然后各自插入一条
boolean exists = packageMapper.exists(cmd.getUserId(), cmd.getMerchantId(),
cmd.getCityCode(), cmd.getCategoryCode());
if (exists) {
throw new BizException("该用户已有免时长套餐");
}
PackageDO pkg = PackageDO.pending(cmd); // 状态:待激活
packageMapper.insert(pkg);
recordMapper.insert(AllocationRecord.of(pkg)); // 分配记录随之多出一条
}
}
修复代码示例
public class FreeDurationService {
private final TransactionTemplate txTemplate;
/** 修复:锁包住「事务提交」,提交完成之后才释放 */
public void allocate(AllocateCommand cmd) {
String key = cmd.getUserId() + ":" + cmd.getMerchantId()
+ ":" + cmd.getCityCode() + ":" + cmd.getCategoryCode();
if (!dimensionLock.tryLock(key, 3, 10, TimeUnit.SECONDS)) {
throw new BizException("该用户免时长正在处理,请稍后重试");
}
try {
// 事务在锁内提交,提交之后才释放锁
txTemplate.executeWithoutResult(status -> {
if (packageMapper.exists(cmd.getUserId(), cmd.getMerchantId(),
cmd.getCityCode(), cmd.getCategoryCode())) {
throw new BizException("该用户已有免时长套餐");
}
PackageDO pkg = PackageDO.pending(cmd);
packageMapper.insert(pkg);
recordMapper.insert(AllocationRecord.of(pkg));
});
} catch (DuplicateKeyException e) {
throw new BizException("该用户已有免时长套餐"); // 唯一索引兜底
} finally {
dimensionLock.unlock(key);
}
}
}
锁的键要落到真正的唯一维度上,过期时间要盖住整个事务,释放放在提交之后;唯一索引只覆盖待激活和已生效状态,套餐关闭后同一个维度仍能重新分配。锁和索引只挡新的写入,已产生的重复记录还要按清单清零并关闭。代码为脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现。
下次遇到这些场景要警惕
- 做「一个用户在同一维度只能有一条」的资格或额度写入时:用两个不同账号在同一秒对同一个用户、同一城市和电池类目提交分配,检查最终只有一条待激活套餐;只点一次、换个用户点,都不算验证过并发。
- 看到某段写入前只有一次查询校验时:先确认这次查重和随后的创建是否在同一个互斥范围里,再看数据库上有没有对应的唯一约束;只加事务不加锁,两个事务照样能同时查到「没有」。
- 已有重复数据时:先按维度统计重复条数和状态,确认保留哪条、其余怎么清零和关闭,再执行清理;清理只解决存量,写入侧的并发控制仍然要做。