为什么异常处理如此重大？

想象一下：你精心开发的PHP应用因一个未处理的错误而突然崩溃，用户看到的是不友善的白屏或致命错误信息。异常处理正是避免这种尴尬局面的关键，它能让你的应用在遇到意外时依然保持优雅。

核心概念：什么是Try-Catch？

try-catch是PHP提供的错误“安全网”机制：

try块：包裹可能出错的代码
catch块：捕获并处理异常
finally块：无论是否异常都会执行的清理代码

// 基础语法示例
try {
    $result = riskyOperation(); // 可能失败的操作
} catch (Exception $e) {
    echo "出错啦：" . $e->getMessage(); // 友善提示
} finally {
    cleanupResources(); // 必须执行的清理
}

实战入门：从零开始掌握异常处理

1. 主动抛出异常

与其让系统报错，不如主动控制错误流程：

function transferMoney($amount, $balance) {
    if ($amount <= 0) {
        throw new InvalidArgumentException("转账金额必须大于0");
    }
    if ($amount > $balance) {
        throw new RuntimeException("余额不足");
    }
    // 正常业务逻辑...
}

2. 精准捕获多种异常类型

不同类型的异常需要不同处理方式：

try {
    processUserRegistration($userData);
} catch (InvalidEmailException $e) {
    // 邮箱格式错误：提示用户重新输入
    return "请输入有效的邮箱地址";
} catch (DuplicateUserException $e) {
    // 用户已存在：提议直接登录
    return "该用户已存在，请直接登录";
} catch (DatabaseException $e) {
    // 数据库错误：记录日志并显示系统繁忙
    error_log("数据库错误: " . $e->getMessage());
    return "系统繁忙，请稍后重试";
}

3. 必须掌握的finally块

资源清理的保障——无论成功失败都会执行：

$file = fopen('data.txt', 'w');
try {
    // 文件操作...
    if (!$operationSuccess) {
        throw new Exception("写入失败");
    }
} catch (Exception $e) {
    echo "操作失败: " . $e->getMessage();
} finally {
    // 确保文件句柄被关闭
    if ($file) {
        fclose($file);
        echo "资源已释放";
    }
}

进阶技巧：打造专业的异常处理体系

自定义异常类：让错误信息更有价值

通用异常信息不够用？创建专属异常类：

class PaymentException extends Exception {
    public function __construct($message, private $transactionId = null) {
        parent::__construct($message);
    }
    
    public function getTransactionId() { return $this->transactionId; }
    public function alertCustomerService() { /* 通知客服 */ }
}

class InsufficientFundsException extends PaymentException {}
class CardExpiredException extends PaymentException {}

// 使用示例
try {
    processPayment(100, $cardInfo, 'TXN_001');
} catch (InsufficientFundsException $e) {
    echo "支付失败：余额不足（交易号：{$e->getTransactionId()}）";
    $e->alertCustomerService(); // 自动通知客服跟进
}

真实场景：完整的文件上传异常处理

class FileUploader {
    const MAX_SIZE = 5 * 1024 * 1024; // 5MB
    
    public function upload($file) {
        try {
            $this->validateFile($file);
            $filename = $this->generateFilename($file);
            $this->moveFile($file, $filename);
            return ['success' => true, 'filename' => $filename];
            
        } catch (FileValidationException $e) {
            return ['success' => false, 'error' => $e->getMessage(), 'code' => 'VALIDATION_ERROR'];
        } catch (FileMoveException $e) {
            return ['success' => false, 'error' => '文件保存失败', 'code' => 'SAVE_ERROR'];
        } finally {
            $this->cleanupTempFile($file); // 确保清理临时文件
        }
    }
    
    private function validateFile($file) {
        if ($file['size'] > self::MAX_SIZE) {
            throw new FileValidationException("文件大小不能超过5MB");
        }
        // 更多验证逻辑...
    }
}

专家级最佳实践

✅ 应该这样做：

1. 异常信息要具体有用

// 差：信息模糊
throw new Exception("错误发生");

// 好：包含具体上下文
throw new DatabaseConnectionException(
    "无法连接到数据库[{$dbName}]，主机：{$host}，错误：" . $pdo->errorInfo()[2]
);

2. 按异常类型分别处理

try {
    $apiResponse = $externalService->call();
} catch (NetworkException $e) {
    // 网络问题：重试逻辑
    return $this->retryAfterDelay();
} catch (AuthenticationException $e) {
    // 认证失败：重新登录
    return $this->redirectToLogin();
} catch (RateLimitException $e) {
    // 频率限制：等待后重试
    sleep($e->getRetryAfter());
    return $this->retry();
}

3. 日志记录要全面

catch (Exception $e) {
    // 记录完整错误信息，包括堆栈跟踪
    error_log(sprintf(
        "[%s] %s in %s:%d
Stack trace:
%s",
        get_class($e),
        $e->getMessage(),
        $e->getFile(),
        $e->getLine(),
        $e->getTraceAsString()
    ));
}

❌ 避免这些常见陷阱：

1. 不要静默吞掉异常

// 危险！问题被隐藏了
try {
    saveImportantData();
} catch (Exception $e) {
    // 什么都不做 <- 这是bug的温床
}

// 应该至少记录日志
try {
    saveImportantData();
} catch (Exception $e) {
    error_log("保存数据失败: " . $e->getMessage());
    // 或者有控制地重新抛出
    throw new DataPersistenceException("数据保存失败", 0, $e);
}

2. 不要用异常控制正常流程

// 错误：用异常做条件判断
try {
    $user = findUserByEmail($email);
} catch (UserNotFoundException $e) {
    $user = createNewUser($email); // 用异常来判断用户是否存在
}

// 正确：先检查再操作
$user = findUserByEmail($email);
if (!$user) {
    $user = createNewUser($email);
}

3. 不要过度捕获异常

// 过于宽泛：可能掩盖真正的问题
catch (Exception $e) {
    // 这会捕获所有异常，包括你没想到的bug
}

// 更准确：只捕获你预期可能发生的异常
catch (SpecificBusinessException $e) {
    // 处理具体的业务异常
}

完整实战：API接口的异常处理架构

class ApiException extends Exception {
    public function __construct(
        $message, 
        private $errorCode, 
        private $httpStatus = 400
    ) {
        parent::__construct($message);
    }
    
    public function toArray() {
        return [
            'success' => false,
            'error' => [
                'code' => $this->errorCode,
                'message' => $this->getMessage(),
                'timestamp' => time()
            ]
        ];
    }
    
    public function getHttpStatus() { return $this->httpStatus; }
}

// 统一的异常处理器
set_exception_handler(function ($exception) {
    if ($exception instanceof ApiException) {
        http_response_code($exception->getHttpStatus());
        header('Content-Type: application/json');
        echo json_encode($exception->toArray());
    } else {
        // 非预期异常，记录详细日志但只给用户通用提示
        error_log("Unexpected error: " . $exception->getMessage());
        http_response_code(500);
        echo json_encode(['error' => '系统内部错误']);
    }
});