PHP如何在try/catch中捕获特定的“$x must be array”异常？

针对你需要精准捕获array_key_exists传入非数组的错误并记录专属上下文日志的需求，提供三种可行方案：

方案一：主动前置校验（推荐） #

在调用array_key_exists前主动检查变量类型，从源头避免错误触发，同时直接记录专属日志：

// 前置类型校验
if (!is_array($maybeAnArray)) {
    // 构造上下文信息
    $logContext = [
        'variable_name' => 'maybeAnArray',
        'actual_type' => gettype($maybeAnArray),
        'actual_value' => $maybeAnArray,
        'timestamp' => date('Y-m-d H:i:s')
    ];
    
    // 记录专属错误日志
    logger()->error('array_key_exists参数类型错误：传入非数组变量', $logContext);
    // 发送专属提示
    logger()->warning('$maybeAnArray因类型不符非数组，请及时处理');
    
    // 可选：抛出自定义异常中断流程（如果需要）
    // throw new InvalidArgumentException('array_key_exists的第二个参数必须为数组');
}

// 校验通过后执行业务逻辑
array_key_exists('blah', $maybeAnArray);

这种方式性能最优，逻辑清晰，还能自定义上下文信息的详细程度。

方案二：精准捕获TypeError异常 #

PHP 7及以上版本中，类型错误会抛出TypeError而非传统Exception，可以捕获该异常并通过错误消息过滤特定场景：

try {
    // 其他业务逻辑
    array_key_exists('blah', $maybeAnArray);
    // 其他业务逻辑
} catch (TypeError $e) {
    // 匹配"must be array"的错误特征（对应array_key_exists的类型错误提示）
    if (str_contains($e->getMessage(), 'must be array')) {
        $logContext = [
            'variable_type' => gettype($maybeAnArray),
            'error_message' => $e->getMessage(),
            'stack_trace' => $e->getTraceAsString()
        ];
        
        logger()->error('array_key_exists传入非数组变量', $logContext);
        logger()->warning('$maybeAnArray因类型错误非数组，请处理');
    } else {
        // 处理其他类型错误
        logger()->error($e);
    }
} catch (Exception $e) {
    // 处理非类型类异常
    logger()->error($e);
}

注意：错误消息的文本可能随PHP版本略有变化，需确保匹配逻辑兼容你的运行环境。

方案三：自定义异常实现精准捕获 #

通过自定义异常类，将前置校验和异常捕获结合，实现最精准的场景识别：

// 定义专属异常类
class NonArrayForKeyExistsException extends Exception {}

// 业务代码
try {
    if (!is_array($maybeAnArray)) {
        throw new NonArrayForKeyExistsException('$maybeAnArray必须为数组类型');
    }
    
    array_key_exists('blah', $maybeAnArray);
} catch (NonArrayForKeyExistsException $e) {
    $logContext = [
        'variable_type' => gettype($maybeAnArray),
        'reason' => '前置校验未通过'
    ];
    
    logger()->error($e->getMessage(), $logContext);
    logger()->warning('$maybeAnArray因xxx原因非数组，请处理');
} catch (Exception $e) {
    // 处理其他异常
    logger()->error($e);
}

这种方式完全避免了通用异常的干扰，所有捕获到的该异常都对应你关注的场景。

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