PHP 8 的 match 表达式未匹配时抛出致命错误 UnhandledMatchError，必须显式处理：确保 default 分支存在且语义明确，严格校验输入类型，优先用枚举约束输入，避免类型不匹配导致跳过所有分支。
PHP 8 中 match 表达式未匹配时会直接抛出 UnhandledMatchError，这不是警告，而是致命错误，必须显式处理。核心解决思路是：**不让它发生，而不是捕获它**。
确保 default 分支存在且语义合理
match 不允许省略 default——哪怕你“确定不会走到那里”，也必须写。但别写成兜底万金油式的空逻辑或静默返回。
- 推荐写法：
default => throw new InvalidArgumentException("Unexpected input: " . var_export($input, true)) - 避免写法：
default => null或default => ''（掩盖问题，后续难调试） - 若业务上真有“无意义输入”，应提前过滤，而非依赖 default 吞掉异常值
确认输入值类型与分支字面量严格一致
90% 的未匹配异常源于类型不匹配：比如数据库返回字符串 "1"，而分支写了 1 => 'active'，"1" === 1 为 false，直接跳过所有分支。
- 调试第一步：用
var_dump(gettype($input), $input)查清真实类型 - 统一策略：输入是字符串？分支全用字符串：
'1', '2' => 'active' - 需要整型？显式转换：
$status = (int)($row['status'] ?? 0)，并结合业务判断(int)'abc'得 0 是否可接受
多值匹配与范围判断要选对模式
不能靠 default 挽救设计缺陷。当输入不是有限枚举，而是连续数值或布尔条件时，需改用 match(true) 结构。
立即学习“PHP免费学习笔记（深入）”；
- 数值区间：
match(true) { $score >= 90 => 'A', $score >= 80 => 'B', default => 'C' } - 多状态共行为：
'pending', 'reviewing', 'approved' => 'in_progress'（注意只能是字面量，不能是变量） - 避免错误写法：
match($x) { 1..5 => 'small' }（PHP 不支持范围语法，会报错）
从源头加固：用枚举或契约约束输入
最根本的解法是让输入本身类型安全。比起动态字符串或整数，枚举（enum）天然适配 match。
- 定义
enum OrderStatus: string { case PENDING = 'pending'; case SHIPPED = 'shipped'; } - 匹配时直接用
match($status) { OrderStatus::PENDING => '待处理', ... }，IDE 可补全，静态分析可校验穷尽性 - 数据库查询后做类型预处理：
$status = OrderStatus::from($row['status'] ?? '')，把错误拦截在进入 match 前
