17370845950

PHP 8.4 中自定义异常必须继承 Exception 或其子类，不可实现 Throwable；推荐使用 LogicException 或 RuntimeException 语义化继承，并利用构造函数参数提升简化定义。

PHP 8.4 中自定义异常类必须继承 Throwable 或其子类

PHP 8.4 并未引入新的异常基类，Exception 和 Error 依然分别继承自 Throwable。你不能直接实现 Throwable 接口（它被声明为不可实现），所有自定义异常必须继承 Exception（或 RuntimeException 等已有子类）。

常见错误是试图写

class MyException implements Throwable

—— 这会报 Fatal error: Cannot implement interface Throwable。

• 正确做法：继承 Exception，可覆写构造函数以支持额外参数（如错误码、上下文）
• 若需区分逻辑错误与运行时故障，优先选 LogicException 或 RuntimeException 作为父类，语义更清晰
• PHP 8.4 支持构造函数参数提升（Promoted Properties），可简化定义：

  class ValidationException extends Exception
  {
      public function __construct(
          string $message = "",
          private int $code = 400,
          ?Throwable $previous = null
      ) {
          parent::__construct($message, $code, $previous);
      }
  }

抛出和捕获自定义异常时注意类型推导与联合类型兼容性

PHP 8.4 的类型系统对异常处理更严格，尤其在使用联合类型注解或 match 表达式处理异常分支时。

• catch 块中若写 catch (ValidationException|PermissionException $e) 是合法的，但 PHP 不会自动推导 $e 的公共方法——需手动断言或使用接口抽象共性
• 函数返回类型若声明为 string|ValidationException，实际无法返回异常对象（异常只能被抛出，不能作返回值），这种写法属于类型误用
• 静态分析工具（如 PHPStan）在 PHP 8.4 下会对 throw new FooException() 后的代码标记为“不可达”，但若该 throw 在条件分支中，需确保所有路径都有明确退出，否则可能触发 Unreachable statement 警告

PHP 8.4 的 throw 表达式支持链式调用但不改变异常传播行为

PHP 8.4 延续了 PHP 8.0 引入的 throw 表达式能力，可用于三元运算、箭头函数等场景，但它只是语法糖，不改变异常的堆栈生成或错误处理流程。

• 例如：

  $user = $id > 0 ? findUser($id) : throw new InvalidArgumentException('ID must be positive');

  此处异常仍按标准方式抛出，debug_backtrace() 会包含箭头函数或表达式所在行
• 不要指望用 throw 表达式绕过 try/catch——它不会静默失败，也不会被自动捕获
• 在属性初始化（如 private string $name = throw new LogicException();）仍不被允许，PHP 8.4 仍未支持属性级异常抛出

调试时别忽略 getTraceAsString() 在 PHP 8.4 中新增的匿名类/函数标识

PHP 8.4 改进了异常追踪输出，对闭包、匿名类实例、箭头函数会显示更准确的来源标识（如 {closure} on line 42 或 class@anonymous::doSomething()），这对定位自定义异常源头很有帮助。

• 若发现 getTraceAsString() 输出中某帧显示 class@anonymous 却找不到对应代码，大概率是某个 new class {} 或 fn() => ... 内部抛出了异常
• 自定义异常类中覆写 __toString() 时，建议调用父类实现并追加业务字段（如 errorCode），避免覆盖原始堆栈信息
• 生产环境禁用 display_errors 时，仅靠日志记录异常，务必确保 getMessage() 和 getTraceAsString() 都被写入，否则很难还原 PHP 8.4 中更精细的调用上下文

自定义异常本身不难，难点在于和 PHP 8.4 的类型推导、表达式语法、调试信息增强这几块咬合时，稍不注意就会掉进「看起来能跑，但 IDE 提示错、静态分析报红、线上日志缺关键帧」的坑里。