PHP报错‘Only arrays and Traversables can be unpacked’无法触发set_error_handler()

为什么set_error_handler()抓不到这个错误？ #

你遇到的「Only arrays and Traversables can be unpacked」错误（错误码2，对应E_WARNING），本质是PHP编译阶段触发的错误，而set_error_handler()只能捕获运行时产生的非致命错误（比如通过trigger_error()抛出的E_USER_ERROR、普通的E_NOTICE/E_WARNING）。编译阶段的错误会直接抛出Error类实例（PHP 7+），不会走自定义错误回调的流程，所以你的errorHandle方法根本不会被触发。

可行的解决办法 #

1. 提前校验，从根源避免错误触发

在使用解包语法之前，先判断变量是否符合要求，直接抛出业务异常：

// 假设$params是你要解包的变量
if (!is_array($params) && !($params instanceof \Traversable)) {
    throw new \InvalidArgumentException('参数必须是数组或可遍历对象');
}
// 确认安全后再解包调用
checkBindParams(...$params);

2. 用try/catch捕获Error实例

PHP 7及以上版本，这类编译/运行时错误会被封装成Error类的实例（和Exception同属Throwable接口），可以直接用try/catch捕获：

try {
    checkBindParams(...$nonTraversable); // 这里触发解包错误
} catch (\Error $e) {
    // 自定义处理逻辑：记录日志、返回友好提示等
    error_log('解包错误：' . $e->getMessage());
    // 不要把原始错误信息暴露给用户
    echo '请求处理失败，请检查参数格式';
}

3. 全局统一处理Throwable

如果想统一处理所有未捕获的Error和Exception，可以注册全局异常处理器：

set_exception_handler(function (\Throwable $e) {
    error_log('未捕获错误：' . $e->getMessage());
    echo '服务器内部错误';
});

这个处理器会捕获所有未被try/catch处理的Exception和Error，适合做兜底处理。

补充说明 #

你之前的errorHandle能处理trigger_error()抛出的E_USER_ERROR，是因为这类错误属于运行时用户自定义错误，完全在set_error_handler()的处理范围内。但解包错误属于编译阶段触发的底层错误，不在这个机制覆盖范围内，所以必须用上面的方法处理。

内容的提问来源于stack exchange，提问作者user13769283