发生了什么
商户是跟平台签约、在某个线下点位经营并收款的经营主体。签约之前,商户要先在商户平台登记一张收款银行卡:提交卡号等信息后,系统保存一条绑卡记录,记录里有两个关键字段,一个是绑定状态,成功时记为 3;另一个是默认标记,取值为 1 时表示这张是默认卡。网点签约是商户为某个线下点位签合同,合同表单里要填收款银行卡号。正常流程是:商户在商户平台绑好卡,系统把这次新绑的卡标成默认;业务打开网点签约页时,页面按商户去查默认卡,把卡号自动带进表单,业务确认后提交。
这次不一样。这个商户的卡此前已经在支付平台绑定过;这次在商户平台再次提交同一张卡,系统按“已经绑过”处理,跳过了重复绑卡,没有产生一次新的绑卡动作。卡在商户名下是已绑定状态,但这次提交没有把默认标记写成 1。签约页的查询只认默认卡,返回结果为空,卡号那一栏就带不出任何内容。
短期处置是业务人员手工把卡号输入表单;记录没有说明这张卡后来是否补上了默认标记。
本质
一句话:签约页把“默认卡”当成了“唯一可用的卡”,而默认标记只在新增绑卡时写入,重复绑卡被跳过后就留下一张有卡、但没有默认卡的状态,查询直接返回空。
- 原流程怎么工作。商户新绑一张卡时,系统新增一条绑卡记录,把绑定状态记为成功,同时把这张卡标成默认。默认标记的含义是“最近一次绑的是哪张卡”,它随着每次新绑卡而变化。
- 这次哪一步不同。同一张卡已经在支付平台存在,商户平台这次提交被判为重复绑卡,跳过了新增绑定。绑定动作没有发生,默认标记也就没有在这次提交里被写上。
- 签约页接着做了什么。页面查询这个商户的银行卡时,条件是默认标记为默认、绑定状态为成功,并且只取其中一张。商户名下虽然有一张绑定成功的卡,但没有一张满足默认条件,查询结果为空。
- 为什么页面会空白。代码把“查默认卡”和“查可用卡”写成了同一件事:查不到默认卡就返回空,页面没有别的兜底,也不会退回去展示其他已绑定的卡。业务看到的就是卡号一栏空白。
- 为什么说这是方案层面的问题。默认标记本身会频繁变化:换一张新卡、从别的入口绑卡,都会让默认标记落到别的卡上。只要页面把默认标记当作唯一入口,这类“有卡无默认”的商户就会反复出现。
修复方向是让签约页不再依赖默认标记:查询该商户全部绑定状态为成功的卡,以列表形式展示,由业务人员选择;默认卡最多作为列表里的预选项,而不是过滤条件。对仍依赖默认卡的存量页面,可以在重复绑卡被跳过时补写一次默认标记作为过渡。记录给出的长期方案还需要产品评估和后端适配,尚未实施,不能当作已经修好;短期仍靠人工输入卡号兜底。
默认标记回答的是“最近绑了哪张卡”,不是“这个商户有没有可用的卡”;把它当成唯一查询条件,已绑定成功的卡也会在页面上消失。
错误代码
// 绑卡与签约页查询:默认标记只在新增绑卡时写入(脱敏教学示例)
public void bindCard(Long merchantId, BankCard card) {
if (paymentClient.hasBound(merchantId, card.getCardNo())) {
// 为什么错:判定为重复绑卡后直接返回,
// 没有为这张已绑成功的卡补上默认标记
return;
}
card.setBindStatus(3); // 3 表示绑定成功
card.setDefaultFlag(1); // 默认标记只在这条新增路径写入
bankCardMapper.insert(card);
}
public BankCardVO getSigningCard(Long merchantId) {
return bankCardMapper.selectByMerchantId(merchantId).stream()
// 为什么错:只取默认卡,没有默认卡的商户直接被过滤成空
.filter(c -> Integer.valueOf(1).equals(c.getDefaultFlag()))
.filter(c -> Integer.valueOf(3).equals(c.getBindStatus()))
.findFirst()
.map(this::toVO)
.orElse(null); // 为什么错:返回空后页面没有兜底,只能显示空白
}
修复代码示例
// 修复:签约页展示全部绑定成功的卡,默认卡只用来预选(脱敏教学示例)
public List<BankCardVO> listSigningCards(Long merchantId) {
List<BankCardVO> cards = bankCardMapper.selectByMerchantId(merchantId).stream()
.filter(c -> Integer.valueOf(3).equals(c.getBindStatus()))
.map(this::toVO)
.collect(Collectors.toList());
if (cards.isEmpty()) {
// 修复:确实没有可用卡时给出明确提示,而不是静默返回空
throw new BizException("该商户没有绑定成功的银行卡");
}
// 修复:默认标记只影响排序,不再决定这张卡是否可见
cards.sort(Comparator.comparing(BankCardVO::isDefault).reversed());
return cards;
}
public void bindCard(Long merchantId, BankCard card) {
if (paymentClient.hasBound(merchantId, card.getCardNo())) {
// 过渡处理:重复提交不新增记录,但要保证存量页面仍有一张默认卡
bankCardMapper.markDefaultIfAbsent(merchantId, card.getCardNo());
return;
}
card.setBindStatus(3);
card.setDefaultFlag(1);
bankCardMapper.insert(card);
}
两段代码对应同一个问题的两端:错误版在重复绑卡时直接返回,而且查询只认默认标记;修复版让签约页返回全部绑定成功的卡,把默认标记降级为排序和预选,重复绑卡时只做一次过渡性的默认卡补齐。记录没有给出实际改动,长期方案还要产品评估与后端适配,上面是按该方向写的示例,未实施也未验证。
下次遇到这些场景要警惕
- 给页面加“自动带出”能力时:先确认它查的是哪条记录、用了哪些过滤条件;构造一条“业务上已存在、但某个标记没写”的数据,比如从另一个入口绑过、没有重新绑的卡,走一遍页面,看还能不能带出内容。
- 处理“已经绑过就跳过”的重复提交时:检查跳过之后有没有漏写下游要用的字段,比如默认标记和状态;用同一张卡在两个入口各提交一次,对比列表、详情和签约页是否一致。
- 在签约、结算这类必须拿到收款账户的页面:不要把“取默认”实现成“取唯一”;确认页面能列出全部可用账户并允许选择,没有默认值时给出提示而不是空白。
- 修改默认项、主账号这类可变标记的写入逻辑前:列出所有读这个标记的地方,评估标记变化后各页面的表现;能改成按业务条件查询的,就不要继续把标记当唯一入口。
代码为脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现;类名、方法名、表名与字段名均为示意。