发生了什么
商户 App 是商家自己用的移动端,里面有钱包。用户每完成一单,平台按分润规则算出商户应得的那部分,结算进商户钱包,页面上显示为“可提现余额”。商户要把钱取走,就在 App 里发起提现:平台把余额打到商户的银行账户,同时在系统里留一条提现记录。钱包页面因此有两个入口,一个看现在还能提多少,一个按日期查历史提现记录;商户核对“钱到哪去了”,靠的是后者。
正常流程是:订单结算,可提现余额增加;商户发起提现,余额相应减少,并生成一条带时间的提现记录;之后商户打开提现记录,按日期筛选,能看到这笔提现以及它的处理结果。余额和记录是从两个方向回答同一个问题,余额说现在还能提多少,记录说提走的钱去了哪里。
这次有一位商户反馈,10 月里有累计一千多元的分润结算进钱包,但打开 App,可提现余额是 0,按近一个月查提现记录也是空的,看起来像结算完成的钱没有到账。核查后确认,这位商户其实已经提过现,款也已经打到银行账户,余额为 0 正是提现之后的正常结果。真正不对的是提现记录:商户按日期查的时候,这笔提现明明落在所选范围内,列表却一条都不返回。目前只有这一条商户反馈,涉及多少商户、多少金额没有统计。
本质
提现记录页把用户选的起止日期拼成接口的查询区间。前端拼参数时,开始时间取所选开始日的 00:00:00,结束时间也取所选结束日的 00:00:00。查询区间因此变成“从开始日零点到结束日零点”,结束日从零点往后的一整天全部落在区间之外。
- 商户选的是一段日期,代码把它当成了两个时刻。日期只说明是哪一天,不说明这一天里的哪一刻;把日期格式化成 00:00:00,等于把“到这一天为止”读成了“到这一天开始为止”。
- 这笔提现发生在所选结束日的白天,时间点在结束日零点之后,正好落在被截掉的那一段里,筛选时被排除。
- 列表返回空,页面渲染成“暂无提现记录”;同一屏上的可提现余额又是 0,两个信息合在一起,只能得出钱没到账的结论。
需求侧也没有把这件事定死:只写了按日期筛选,没有约定结束日期应取当天最后一刻还是次日零点,前端按字面取了零点。现在的改法是把结束时间改成所选日期的 23:59:59,让结束日整天进入区间,随这次迭代发布上线;发布后是否拿历史提现复核过,没有写明。
“按日期筛选”的结束日期,语义是“到这一天为止”;把它当成时刻、取当天 00:00,结束日的数据就整体落在区间之外,列表会少一天。
同样要在需求里写明日期区间的边界约定,避免下一处筛选再按字面取零点;如果接口支持,用“次日零点、左闭右开”表达结束边界更稳,可以避开 23:59:59 之后不足一秒的记录。
错误代码
// 提现记录查询(脱敏教学示例)
function buildWithdrawQuery(range) {
return {
startTime: formatDay(range.start) + " 00:00:00",
// 为什么错:结束日期也取当天 0 点,区间到结束日的开头就停了
endTime: formatDay(range.end) + " 00:00:00",
pageNo: 1,
pageSize: 20,
};
}
async function loadWithdrawRecords(range) {
const { list, total } = await withdrawRecordApi.list(buildWithdrawQuery(range));
// 为什么错:空列表直接渲染成“暂无提现记录”,页面又同时展示可提现余额 0,
// 商户无法区分“钱还没到账”和“钱已经提走了”
renderWithdrawList(list, total);
renderBalance(wallet.balance);
}
修复代码示例
// 同一段查询:结束日期展开到当天最后一刻
function buildWithdrawQuery(range) {
return {
startTime: startOfDay(range.start), // 开始日仍是 00:00:00,边界含义不变
// 结束日期代表“到这一天为止”,取当天 23:59:59,结束日的记录才在区间内
endTime: endOfDay(range.end),
pageNo: 1,
pageSize: 20,
};
}
async function loadWithdrawRecords(range) {
const { list, total } = await withdrawRecordApi.list(buildWithdrawQuery(range));
// 列表空只说明该区间内没有记录,不能与余额为 0 合成一个结论
renderWithdrawList(list, total);
renderBalance(wallet.balance);
}
function endOfDay(date) {
return formatDay(date) + " 23:59:59";
}
下次遇到这些场景要警惕
- 给列表加按日期筛选时:让开始日和结束日取同一天,构造这一天零点、零点之后各一条数据,确认两条都能查到;只验证“区间内某一天”会漏掉结束日的边界。
- 前后端联调日期区间参数时:把“日期落到具体时刻”的约定写进接口说明,明确结束日是取最后一刻还是次日零点、区间左闭还是左开,并确认两端对同一个参数的理解一致。
- 排查“余额为 0、记录为空”的反馈时:把余额和记录分开看,余额对不上是账务问题,记录为空可能只是查询区间把它截掉了;用不带时间条件的查询对照一次。
- 改完边界之后:拿已经发生过的提现,用同样日期范围重新查一遍,确认历史记录能查到,再请反馈人复核。