发生了什么
用户拥有的一份套餐,代表一段时间内使用服务的资格,这份资格在系统里是一条套餐记录。套餐除了正常生效,还可能被「冻结」:冻结是套餐的一种临时状态,被冻结后要经过一次「解冻」才回到正常状态。
能发起冻结的有两种东西。一种是按城市配置的冻结活动,活动有结束时间,到期后系统会自动解冻;另一种是业务侧下发的冻结卡,卡有有效期,在有效期内可以拿它冻结套餐,但卡过期后不会自动解冻,套餐会一直停在冻结中,直到有人操作解冻。这是两种来源在过期后的不同规则,也是这次问题的前提。
用户打开个人中心时,后端返回这份套餐的冻结状态和冻结标记两个字段,前端根据它们显示「冻结中」文本和冻结状态对应的操作按钮。另有一个冻结二级页,专门展示冻结详情并处理解冻。正常情况下两个页面的说法应该一致:套餐冻结中,两处都显示冻结中的状态和解冻入口;套餐已解冻,两处都不再显示。
这次出问题的是一个用冻结卡冻结的用户。冻结卡到期了,按冻结卡的规则,套餐仍然是冻结中,并没有自动解冻。但个人中心没有显示「冻结中」文本,按钮也仍按未冻结展示;点进冻结二级页,页面却显示「确认解冻」。同一个人、同一份套餐,一个页面像是没冻结,另一个页面说还可以解冻。
影响范围有限:只有用冻结卡冻结、且卡到期后还没解冻的用户会遇到;出问题的是个人中心的文本和按钮。用户在二级页仍能自己操作解冻,正常使用没有受影响。记录没有给出受影响用户数。
本质
一句话:个人中心把「是否还在活动时间内」当成了「套餐是否冻结」。冻结卡到期后,活动时间判断变成否,程序就不再写入冻结信息,页面于是把仍在冻结的套餐显示成未冻结。
拆开看:
- 原来只有冻结活动时,这个判断是成立的:活动结束等于自动解冻,套餐不再冻结,个人中心不显示冻结中是对的。
- 后来多了冻结卡这个来源。冻结卡过期不自动解冻,套餐还在冻结中,但它的到期时间也被放进了同一个活动时间判断里。
- 个人中心查询时,程序先算是否在活动时间内。这次日志里这个结果是 false,说明按活动时间算已经结束。
- 程序只在「在活动时间内」这个分支里写入冻结状态和冻结标记;条件不成立,就没有执行写入,页面拿到的不是这份套餐当前真实的冻结状态。
- 前端按这两个字段渲染:字段没有写成冻结,就不显示「冻结中」文本,按钮也按未冻结展示。
- 冻结二级页没有经过这段活动时间判断,它看的是这份冻结还在不在:套餐仍处于冻结中、也还能操作解冻,所以页面显示「确认解冻」。个人中心按活动时间算,二级页按冻结是否还在算,两个页面结论就相反了。
「活动结束」只对活动冻结等于「自动解冻」;换成不自动解冻的冻结卡,同一个判断就把仍在冻结的套餐显示成了未冻结。
修复方向是:冻结状态以冻结记录本身为准,活动时间只用于判断活动冻结是否到期;活动到期走自动解冻,冻结卡到期仍保持冻结,直到用户确认解冻。个人中心和冻结二级页应共用同一份状态计算,不再各自推导。记录给出的处理是产品已排期优化、预计 6 月 4 日修复,是否已经上线、是否验证没有说明。
错误代码
// 个人中心:用「是否在冻结活动时间内」推导冻结状态
public UserCenterView buildUserCenter(Long userId) {
ActivityInfo activity = activityClient.getFreezeActivity(userId);
boolean duringActivityTime = activity != null
&& now().isBefore(activity.getEndTime()); // 为什么错:冻结卡也走这个结束时间,卡过期后为 false
UserFreezeView freeze = UserFreezeView.notFrozen();
if (duringActivityTime) {
freeze.setFreezeStatus(FROZEN); // 只有活动期内才写入冻结状态
freeze.setFreezeFlag(true);
}
// 为什么错:条件不成立就跳过写入,卡过期后套餐仍冻结,页面却拿到未冻结字段
return new UserCenterView(freeze);
}
// 冻结二级页:直接查冻结记录,记录还在就显示「确认解冻」
public FreezeDetailView buildFreezeDetail(Long userId) {
FreezeRecord record = freezeRepository.findUnfrozen(userId);
return record == null ? FreezeDetailView.none() : FreezeDetailView.canUnfreeze(record);
}
修复代码示例
// 两个页面共用同一份状态,不再各自推导
public UserCenterView buildUserCenter(Long userId) {
return new UserCenterView(UserFreezeView.of(freezeStateService.current(userId)));
}
public FreezeDetailView buildFreezeDetail(Long userId) {
FreezeState state = freezeStateService.current(userId);
return state.isFrozen() ? FreezeDetailView.canUnfreeze(state) : FreezeDetailView.none();
}
// 状态只由冻结记录决定,活动时间只用来判断活动冻结是否到期
public FreezeState current(Long userId) {
FreezeRecord record = freezeRepository.findUnfrozen(userId);
if (record == null) {
return FreezeState.notFrozen();
}
boolean activityExpired = record.getSource() == FreezeSource.ACTIVITY
&& !now().isBefore(record.getEndTime());
if (activityExpired) {
return FreezeState.notFrozen(); // 只有活动冻结自动解冻;冻结卡到期不走这里
}
return FreezeState.frozen(record);
}
两段代码改的是同一处:错误版把活动结束时间当成冻结状态,条件不成立时干脆不写字段;修复版把判断收回到冻结记录上,按来源区分过期规则,并让两个页面读同一个状态。代码为脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现。
下次遇到这些场景要警惕
- 新增一种能让套餐进入冻结、暂停或失效的来源时:先列出所有推导「当前是否冻结」的位置,逐个确认新来源过期后是自动恢复还是保持原状,别只改写入冻结记录的那一处。
- 多个页面都要展示同一个状态时:让个人中心、详情页这类入口共用同一个状态计算,或直接读同一条状态记录;两个页面各自按不同依据推导,很容易出现一个说冻结、一个说没冻结。
- 构造「来源已过期、但状态要保持」的样本:用一张已到期的冻结卡冻结套餐,分别打开个人中心和二级页,检查文本、按钮是否一致,再点一次解冻确认能恢复。
- 看到
if (在有效期内) { 写状态 }这类只有写入、没有 else 的字段赋值时:确认条件不成立时字段应该是什么值,接口是否会把旧值或默认值当成当前状态返回。