凌晨两点十七分,监控告警:订单详情接口 500,错误率 12%。日志里一行 Fatal error: UnhandledMatChError: Unhandled match CASe 6 in /data/www/app/Service/OrderService.php on line 88,堆栈指向状态文案的 match。
前一天下午刚上了个需求,新增订单状态 6 表示部分退款。写 match 的同事只补了前端文案,后端这个 match 里没有 6,也没写 default。PHP 8 的 match 跟 switch 不一样,没有匹配到任何分支就抛 UnhandledMatchError,不是静默返回 null。
第二个坑在同一个文件里。另一个 match 用状态值做分支,分支写的是 2、3 这样的 int,而状态是从 PDO 取出来的,默认返回字符串 "2"。match 用全等比较,"2" 不等于 2,所有订单都落到 default,文案全变成未知状态。这个 bug 上线三天没人发现,因为 default 兜底写的是空字符串,页面只是看起来少了一行字。
试过给第一个 match 加 default => null,接口不 500 了,但前端拿到空文案,客服当天收到十几条反馈说订单状态是空白。改成 default 抛业务异常,由上层统一转成 400 加提示,至少日志里能看出是哪个状态没覆盖。
$text = match ((int) $status) {
1 => '待付款',
2 => '已付款',
6 => '部分退款',
default => throw new OrderStatusException(
'unknown status ' . $status
),
};
验证方式是补了一个数据提供器,把 0 到 9 十个状态值挨个传进去,断言每个都有返回或者抛出预期异常。这个用例在 CI 里跑,以后再新增状态,忘了改 match 会直接红。
另外把项目里所有 match 搜了一遍,一共 23 处,其中 5 处没有 default,逐个确认了入参范围才放过。状态字段的输出统一加了 int 强转,避免字符串和整数比较这种事再发生。
