发生了什么

用户在线购买套餐时可以挑一张优惠券抵扣。券能不能用,不只看它有没有过期:下单时还有一道规则校验。券的适用范围按商户合作模式划分,所以校验程序要先拿到这笔订单所属商户的“合作模式私域属性”,再拿它去比对券规则。商户的这些属性存在商户主数据里,按商户编号查。

平台里另有一类兜底商户。系统没有给用户确定真实商户时,先把归属记到兜底商户上。它是一个占位编号,不对应任何一家真实经营的商户,所以商户主数据里没有它的合作模式、私域属性这些内容。

还有一部分老用户带着“保护期”:保护期内下单,订单归属沿用用户档案上当初记的那个商户,不按当前应属的商户重新确定,这段时间里归属不变。

正常流程是:用户选中套餐和券 → 下单程序按用户档案找出这笔订单归属的商户 → 按商户编号查它的合作模式私域属性 → 优惠券校验程序拿这个属性比对券规则 → 通过就锁券、抵扣、生成订单。

这次出问题的是一批 2021、2022 年注册的老用户,他们档案上的保护期商户正是那个兜底商户。下单时程序按兜底商户的编号去查私域属性,没有查到,带进校验的是一个空值;校验程序判定“缺少私域字段”,规则校验不通过,券锁不上,用户也就没法用这张券下单。受影响的不是一个人,是同一批历史用户。

本质

一句话:优惠券校验要的商户属性,是从“订单归属商户”这条主数据里取的;这批老用户的归属商户是个占位编号,主数据里没有这条记录,取到的属性为空,空值又被当成“这张券不满足规则”,于是券在下单第一步就被拦下了。

  1. 券本身有效。券规则写的是“这个合作模式下的私域活动可用”,规则没有问题,缺的是判断依据。
  2. 归属商户由用户档案决定。保护期把归属固定在档案上记的那个商户,下单时不再按当前规则重算,所以这个商户是谁,完全取决于档案里的历史值。
  3. 历史值指向兜底商户。兜底商户是给“确定不了商户”兜底用的占位编号,不是真实主体,主数据里没有它的合作模式和私域属性。
  4. 查属性这一步没有兜底。程序按编号查不到就让结果为空,把空值原样交给校验程序,没有把“查不到这个商户”当成一种需要单独处理的数据状态。
  5. 校验程序把空值当成不满足。它看到私域属性为空,给出的结论是规则校验失败、缺少私域字段,锁券这一步不执行,用户下单时这张券用不了。

“取不到”和“不该有”是两件事:属性为空说明这条档案指不到真实商户,并不说明用户没有用券资格;两者合成一个校验失败,用户和排查的人都看不到真正原因。

修复分两头。存量数据这边,把这批保护期商户是兜底商户的用户的保护期关掉,用户重新下单时会按当前规则取到新的兜底商户,不再沿用指向占位记录的历史值。代码这边,判断保护期商户是兜底商户、且私域属性取不到时,按自营返回这个属性,让老用户能按自营的券规则下单。改动是否已经上线、用哪些用户验证过,目前没有确认。

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

错误代码

// 下单前准备优惠券校验所需的商户属性(脱敏教学示例)
public CouponContext buildCouponContext(String userId) {
    UserProfile user = userRepo.get(userId);
    // 为什么错:保护期内沿用档案上的商户,这个编号可能是历史占位记录,
    // 但这里只把它当普通商户编号往下传
    String merchantId = user.getProtectMerchantId();
    // 为什么错:占位商户在主数据里没有记录,查询返回空,
    // 代码没有区分“这条商户不存在”和“这个商户没有配置私域属性”
    String privateDomain = merchantModeRepo.queryPrivateDomain(merchantId);
    CouponContext ctx = new CouponContext();
    ctx.setPrivateDomain(privateDomain);   // 空值被原样带进校验
    return ctx;
}
// 优惠券规则校验(脱敏教学示例)
public void validate(CouponContext ctx, CouponRule rule) {
    // 为什么错:私域属性为空时直接判成规则不满足,提示“缺少私域字段”,
    // 真实原因(归属商户是占位记录)没有传递出来
    if (ctx.getPrivateDomain() == null) {
        throw new CouponCheckException("规则校验失败:缺少私域字段");
    }
    if (!rule.getPrivateDomain().equals(ctx.getPrivateDomain())) {
        throw new CouponCheckException("规则校验失败:券不适用于该商户");
    }
}

修复代码示例

// 修复:占位商户取不到私域属性时按自营返回(脱敏教学示例)
private static final String PLACEHOLDER_MERCHANT = "占位商户编号";
public CouponContext buildCouponContext(String userId) {
    UserProfile user = userRepo.get(userId);
    String merchantId = user.getProtectMerchantId();
    String privateDomain = merchantModeRepo.queryPrivateDomain(merchantId);
    // 修复:只在保护期商户是占位商户、且属性确实取不到时补默认值;
    // 占位商户的含义就是平台自营,老用户按自营的券规则下单
    if (privateDomain == null && PLACEHOLDER_MERCHANT.equals(merchantId)) {
        privateDomain = CooperationMode.SELF_OPERATED.privateDomain();
    }
    CouponContext ctx = new CouponContext();
    ctx.setPrivateDomain(privateDomain);
    return ctx;
}
// 校验逻辑不变:真实商户缺配置时仍然失败,避免把配置缺失一并放过
public void validate(CouponContext ctx, CouponRule rule) {
    if (ctx.getPrivateDomain() == null) {
        throw new CouponCheckException("规则校验失败:缺少私域字段");
    }
    if (!rule.getPrivateDomain().equals(ctx.getPrivateDomain())) {
        throw new CouponCheckException("规则校验失败:券不适用于该商户");
    }
}

两段代码改的是同一处:错误版把“查不到属性”直接交给校验,修复版在构造上下文的入口把占位商户的缺失补成明确的自营属性,校验逻辑保持原样,真实商户缺配置时照样失败。这次只处理了“保护期商户是占位商户”这一种情况;如果还有别的入口按这个占位编号去取商户属性,同样的缺失可能出现在别处,记录里没有说明是否一并核对过。

下次遇到这些场景要警惕

  • 下单、结算这类流程要读另一个域的商户属性时:先把存量数据里可能出现的取值列全(真实商户、占位编号、空值、已作废编号),逐个构造一次下单流程,看提示是“数据缺失”还是“规则不满足”。
  • 设计“保护期、沿用旧值”这类逻辑时:写清楚旧值可能已经不存在(商户下线、合并、编号作废),并约定旧值失效时回落到什么,不要假设档案上的商户编号永远能查到记录。
  • 做兜底配置(兜底商户、默认渠道、默认账号)时:先定义清楚它的语义是“占位”还是“真实主体”,再盘一遍所有按它取业务属性的位置;占位主体被当真实主体查属性,缺失会一路传到最外层的校验。
  • 看到“缺少某字段”这类校验失败时:先确认这个字段是用户输入、本系统配置,还是从别的域查来的;从别处查来的字段要把“查不到”和“值不对”分开报,否则只能靠人翻日志才能定位是哪条数据不完整。