fix(pay): 余额充值预设档位不再被 custom_price 参数校验拦截

选中任一预设充值档位点「立即支付」,必然弹「无效参数:custom_price」。这是 WP
REST 的参数校验层拦截,请求根本没进业务回调。

原因是 WP REST 的 default 只在「键完全缺失」时生效,键存在但值为空串时 default
不参与,空串会直接送进 pattern 校验:

  'custom_price' => ['type' => 'string', 'default' => '0', 'pattern' => '^(0|[1-9]\d*)(?:\.\d{1,2})?$']

而前端提交时无条件带上该字段(custom_price: custom),选预设档位时 custom 恒为
''。更隐蔽的变体:后台关掉「自定义充值金额」后模板不再渲染该输入框,customEl 为
null、custom 仍是 '',也就是只放开预设档位的配置下 100% 复现。

该字段只在 package=custom 时被消费,而金额格式与区间的业务裁决早已完整存在于
create_charge_order()(AssetAmount::balance 严格正则 + 溢出检查,再按 custom_limit
校验区间并返回本地化错误)。参数声明上的 pattern 是同一规则的第二份实现,两套口径
不同步即是本次缺陷来源。故本次按「单一口径」收口,不再采用「放宽 pattern + 回调归一化
空串 + 前端改送 '0'」的三处并行写法:

- BalanceServiceRest:custom_price 参数去掉 pattern、default 改为 ''、显式声明
  sanitize_callback;rest_charge_create 改为经声明式 args 用 $request->get_param()
  取值,不再手工重读 JSON 体
- credits.js:selectProduct 选中预设档位时清空自定义金额输入(否则框内残留数字会在
  提交时把 package 顶回 custom,静默覆盖用户刚点的档位);customInput 声明上移,去掉
  「先调用后赋值」的时序依赖
- balance-charge-modal.test.cjs:新增 2 项契约测试 / 6 条断言

清理的死代码:
- rest_charge_create 中手工 get_json_params() 并复刻 sanitize_text_field/sanitize_key
  的一段:与声明的 sanitize_callback 重复,使那些声明形同虚设(实为第二套取值路径)
- credits.js 提交处理器内重复读取 payment_method 的死分支(处理器开头已读取,中间无
  任何代码改动它)

放宽仅限「空串 / 键缺失」这一种情形:package=custom 而金额为空、非法或越界仍一律
400,007、abc、1e3、1.234、负数等仍被 AssetAmount::balance() 拒绝,失败方向仍是收紧。

行为变化(需知悉):
- 金额裁决权归 AssetAmount::balance(),其内部 trim() 使带首尾空格的金额被修剪后接受,
  此前被参数层 pattern 直接拒绝。这是「单一裁决者」的必然结果。
- 点选预设档位会清空自定义金额输入框,是修复该档位被静默覆盖的必要行为。

验证:node --test 全量 372 项 / 372 通过(原 370 项,新增 2 项);PHPUnit 44 项 /
106 断言通过;改动 PHP 文件 php -l 通过。变异验证:把 6 条关键断言跑在修复前的文件
内容上,6/6 转红,证明回归测试拦得住此缺陷。未做视觉验收,弹窗标记与 CSS 未改动。
This commit is contained in:
2026-09-19 11:34:12 +08:00
parent ce21cc2b9b
commit 0d617d88c9
3 changed files with 71 additions and 15 deletions
+8 -7
View File
@@ -355,12 +355,18 @@
});
// Zibll data-for/data-value 选中模型:余额档位(.vip-product.product-box)
// 选中变化不产生 change 事件(隐藏 input 由程序赋值),需显式重置幂等键。
var customInput = modal.querySelector('input[name="custom_price"]');
function selectProduct(value) {
modal.querySelectorAll('[data-for="balance_product"]').forEach(function (el) {
el.classList.toggle('active', el.getAttribute('data-value') === value);
});
var hidden = modal.querySelector('input[name="balance_product"]');
if (hidden) hidden.value = value;
// 选中预设档位即代表放弃自定义金额:清空输入框,否则框里残留的数字会在
// 提交时按「合法自定义金额」把 package 顶回 custom,静默覆盖刚点的档位。
if (value !== 'custom' && customInput) {
customInput.value = '';
}
if (form) resetOperationKey(form);
}
modal.querySelectorAll('[data-for="balance_product"]').forEach(function (el) {
@@ -368,7 +374,6 @@
selectProduct(el.getAttribute('data-value'));
});
});
var customInput = modal.querySelector('input[name="custom_price"]');
if (customInput) {
customInput.addEventListener('input', function () {
if (String(customInput.value || '').trim() !== '') {
@@ -444,12 +449,6 @@
notyf('请选择或输入充值金额', 'danger');
return;
}
var methodEl = form.querySelector('input[name="payment_method"]');
var method = methodEl ? methodEl.value : '';
if (!method) {
notyf('暂无可用支付方式', 'danger');
return;
}
busy = true;
notyf('正在创建充值订单…', 'load', '', 'aksrt-balance-charge-toast');
api('/pay/balance/charge', {
@@ -457,6 +456,8 @@
headers: { 'Idempotency-Key': operationKey(form) },
body: JSON.stringify({
package: pkg,
// 预设档位下该字段为空串:服务端仅在 package=custom 时消费它,
// 空串表示「未使用自定义金额」,不是非法值。
custom_price: custom,
payment_method: method
})