发生了什么

用户在手机端的“我的套餐”页面能看到自己买过的套餐。套餐是用户买下的一段可用服务资格,里面带着可用天数;买下来之后不一定立刻生效,未生效期间在页面里单独列出。等到激活时,系统会写入一个结束时间,之后用户还能不能用,就按这个结束时间判断。

未生效的套餐也会显示一行有效期,让用户知道这份套餐大概能用多久。这一行天数来自售卖侧(下称 B 端)随套餐下发的配置对象(下称套餐配置),用户端(下称 C 端)拿这份配置组装页面。

正常情况下,未生效套餐显示的天数应当等于用户实际可用的天数。这一次有用户反馈,自己未生效套餐的有效期显示成七千多天,接近二十年。核对下来,出问题的只有 C 端未生效套餐这一处文案:套餐激活之后,页面上的有效期就恢复正常;用户实际能用多久、能不能用,都没有变化。

本质

同一个字段,两端理解成了两种东西。

B 端组装套餐配置时,往 validityDate 字段里填的是这一批套餐的总额度,例如 7500。这是历史遗留的填法:这个数表示这一批的总量,并不是这个用户的可用天数;字段名看起来像日期,装的却是一个数量。

C 端渲染未生效套餐的有效期时,读的正是这个字段,并且把它当成“用户可用天数”直接换算成页面上那行有效期。7500 被展开成七千多天,页面照实渲染,用户看到的就是这个结果。

生效中的套餐没有跟着出错,原因是激活走的是另一条计算:激活时 C 端写入的结束时间等于激活时间加上订单剩余额度,这条路径不读 validityDate。同一份套餐,激活前按那个被当成天数的总额度换算,激活后按激活时算出的结束时间展示,两处对不上,长度自然对不上。

这种错不会被接口报错拦住,只会在页面上变成一个离谱的日期。

影响范围目前只到展示层,业务规则没有变。修复要产品先定规则:未生效套餐不展示有效期、统一展示“激活后生效”,或者要求 B 端改传用户可用天数。规则定下来之前,能做的只是不再拿这个字段推算天数。

以下两段为脱敏教学示例,用于说明字段含义错配与修复方向,不代表实际项目源码或已上线实现。

错误代码

// 用户端套餐页:把套餐配置转换成页面展示对象(脱敏教学示例)
public class PackageDisplayService {

    public PackageVO build(PackageConfig config, OrderInfo order) {
        PackageVO vo = new PackageVO();
        vo.setPackageName(config.getPackageName());

        if (!order.isActivated()) {
            // 为什么错:validityDate 在上游装的是这一批的总额度,这里当成了用户可用天数
            Integer days = config.getValidityDate();
            LocalDate start = LocalDate.now();
            LocalDate end = start.plusDays(days);
            vo.setValidityText(start + " 至 " + end + ",共 " + days + " 天");
        } else {
            vo.setValidityText(order.getEndTime().toLocalDate() + " 到期");
        }
        return vo;
    }
}

错误就出在取数那一行:字段在上游装的是总额度,这里按天数用,接口不会报错,类型也都是整数,页面上没有任何环节能发现这个差别。

修复代码示例

// 修复方向:未生效套餐不拿总额度推算天数(脱敏教学示例)
public class PackageDisplayService {

    public PackageVO build(PackageConfig config, OrderInfo order) {
        PackageVO vo = new PackageVO();
        vo.setPackageName(config.getPackageName());

        if (!order.isActivated()) {
            // 改:只读语义明确的“用户可用天数”,取不到就不编数字
            Integer usableDays = order.getUsableDays();
            if (usableDays == null || usableDays <= 0) {
                vo.setValidityText("激活后生效");
            } else {
                LocalDate start = LocalDate.now();
                vo.setValidityText(start + " 至 " + start.plusDays(usableDays) + ",共 " + usableDays + " 天");
            }
        } else {
            vo.setValidityText(order.getEndTime().toLocalDate() + " 到期");
        }
        return vo;
    }
}

修复示例只改取数来源和兜底文案:不再读含义含糊的 validityDate,改用语义明确的可用天数;取不到就展示“激活后生效”,不拿别的字段凑一个数字。这是可以采用的方向,不是已经实施的修复。

下次遇到这些场景要警惕

  • 页面要展示一个自己算出来的日期或天数时:先确认来源字段在提供方的真实含义和单位,再拿这一批的总额度、上限值这类极端数据跑一次页面,看会不会算出几十年后的日期。
  • 同一份配置被展示、激活、扣减多处读取时:把这些读取点列全,逐个核对它被当成日期、天数还是额度;本次激活流程恰好不读这个字段,才没有把展示错误带进业务数据,下一个读它的流程未必这么巧。
  • 准备拆分或改名一个含义混杂的历史字段时:先让新字段上线并双端写值,确认所有读方都切换过去再停旧字段;只改一端的含义,另一端仍按旧含义解读,展示会直接失真。
  • 收到“时间不对”的反馈只有一张截图时:先查激活记录和真实结束时间,确认是展示层算错还是业务数据错,再决定改文案还是改数据。