PHP 业务异常和系统异常

PHP异常处理深度剖析：业务异常与系统异常的边界、捕获与最佳实践

目录导读

1. 引言：异常不是Bug，而是程序的语言
2. 核心概念：业务异常（可预期）VS 系统异常（不可控）
3. 实操指南：如何用代码优雅区分两类异常
4. 高级策略：全局异常处理器与日志分级
5. 常见问答：解决你关于异常的5个疑问
6. 建立你的异常“红绿灯”机制

引言：异常不是Bug，而是程序的语言

在PHP开发中，异常（Exception）常被误解为“错误”，但优秀的架构师会告诉你：异常是业务规则与系统边界在代码层面的显性表达，如果我们不区分“用户余额不足”和“数据库连接超时”，所有异常都堆在同一个catch块里，代码将迅速腐烂，本文将基于PHP 7+及现代框架（Laravel/Symfony）的实践,深度拆解这两类异常的管理哲学。

核心概念：业务异常（可预期）VS 系统异常（不可控）

关键区别：业务异常是逻辑分支（需要返回给用户看），系统异常是故障信号（需要发送给运维看）。

实操指南：如何用代码优雅区分两类异常

第一步：定义异常基类

// 业务异常基类
class BusinessException extends \RuntimeException {
    protected $errorCode;
    public function __construct($message, $code, $errorCode) {
        parent::__construct($message, $code);
        $this->errorCode = $errorCode;
    }
    // 获取业务错误码（用于前端翻译）
    public function getErrorCode() { return $this->errorCode; }
}
// 系统异常推荐直接使用原生类或自定义标记接口
interface SystemExceptionInterface {}

第二步：在Service层定向抛出

// 业务层：抛出业务异常（带提示信息）
public function withdraw($amount) {
    if ($amount > $this->balance) {
        throw new BusinessException('余额不足', 400, 'BALANCE_NOT_ENOUGH');
    }
    // 系统操作（如调用支付网关）
    try {
        $this->gateway->charge($amount);
    } catch (\Exception $e) {
        // 关键：包装为系统异常，丢失敏感SQL，保留错误上下文
        throw new SystemException('支付网关调用失败', 500, $e);
    }
}

第三步：入口文件分层捕获

在index.php或中间件中，采用双catch块或instanceof判断。

try {
    $response = $kernel->handle($request);
} catch (BusinessException $e) {
    // 返回200状态码 + JSON业务错误码（前端可读）
    return json_encode(['code' => $e->getErrorCode(), 'msg' => $e->getMessage()]);
} catch (\Throwable $e) { // 捕获所有系统异常/错误
    // 记录完整堆栈到error_log
    Log::error($e->getTraceAsString(), ['uri' => $request->getUri()]);
    // 返回500 + 通用文案
    return response('System Busy', 500);
}

高级策略：全局异常处理器与日志分级

• 使用框架的Rendering：在Laravel的Handler中，对BusinessException直接return response()->json(...)，对SystemException先上报到Sentry（监控系统）,再返回兜底500。
• 日志分级：业务异常打印为INFO级别（记录用户行为），系统异常打印为ERROR级别（触发告警）。
• 重试机制：针对系统异常中的ConnectionException，使用指数退避策略重试3次；业务异常绝不重试（避免重复扣款）。

常见问答：解决你关于异常的5个疑问

建立你的异常“红绿灯”机制

• 绿灯（业务异常）：让用户知道下一步怎么做（改参数、转人工）。
• 红灯（系统异常）：让开发者知道系统哪里坏了（发告警邮件、监控大屏）。

最终忠告：永远不要在catch块里echo出异常，而是转换并上抛，在微服务架构中，请用RPC框架的ErrorCode传递业务异常，用熔断器解决系统异常，当你能清晰回答“这个异常该给谁看？”时,你的PHP代码已经具备生产级水准。

关注点：本文已综合PHP官方文档、Laravel异常处理手册及Stack Overflow高赞问答，结合搜索引擎高频关键词（“PHP异常类型”、“业务异常处理Laravel”）进行去重重组,确保内容对SEO友好。