PHP中抛出自定义异常需用throw new MyException(),且该类必须继承Exception;否则触发Fatal error。关键点:继承强制、构造须调用parent::__construct()、catch时注意命名空间与类型顺序。

PHP里怎么抛出自定义异常类
直接用 throw 关键字 + 自定义异常类实例即可,但必须确保这个类继承自 Exception 或其子类(比如 RuntimeException),否则 PHP 会报致命错误 Fatal error: Uncaught Exception。
常见写法:
throw new MyCustomException('用户余额不足', 402);
其中 MyCustomException 是你自己定义的类,构造函数通常会把消息和错误码传给父类 Exception::__construct()。
- 不继承
Exception→ 运行时报错,不是警告 - 没写
extends Exception却用了throw new Xxx→ 同样致命 - 建议在类里重写
__toString()方便日志调试,但非必需
自定义异常类要怎么写才合规
核心就一条:必须 extends Exception。PHP 对异常类没有额外接口强制要求,但为了兼容性(比如被 catch (Exception $e) 捕获),不能跳过继承。
最小可用示例:
class PaymentFailedException extends Exception {}
更实用的写法会补全构造逻辑和类型提示:
class ValidationErrorException extends Exception
{
public function __construct(string $message, int $code = 400, ?Throwable $previous = null)
{
parent::__construct($message, $code, $previous);
}
}
-
$previous参数用于链式异常(比如底层 PDO 异常包装成业务异常) - 如果只重写
__construct却忘了调用parent::__construct()→ 异常对象内部状态损坏,$e->getMessage()可能为空 - 不要在自定义异常类里加太多业务逻辑(比如自动发告警),它该是纯数据载体
throw时传参不对会导致什么问题
throw new XxxException() 的参数顺序和类型必须匹配你类中 __construct() 的签名。PHP 不会自动帮你映射到父类的 $message 和 $code —— 如果你没显式调用 parent::__construct(),那两个属性压根不会被初始化。
典型翻车场景:
- 写了
public function __construct($code, $message),但调用时new Xxx('xxx', 500)→$code变成字符串,$message变成整数,后续$e->getCode()返回字符串,可能破坏 if 判断 - 构造函数声明了
int $code类型,但传了字符串'404'→ PHP 8+ 严格模式下直接 TypeError - 漏掉
parent::__construct()调用 →$e->getMessage()、$e->getCode()全是默认值(空字符串和 0)
catch时为什么有时捕不到自定义异常
最常见原因是 catch 的类型太窄,或者命名空间没对上。PHP 的异常捕获是严格类型匹配的,不会因为“继承了 Exception”就自动向上兼容,除非你明确 catch (Exception $e)。
比如:
try {
throw new App\Exceptions\PaymentException('timeout');
} catch (PaymentException $e) { // ❌ 错:没带完整命名空间
// 不会进来
}
catch (\App\Exceptions\PaymentException $e) { // ✅ 正确
// 进来
}
- 没用
\开头且没use导入 → PHP 在当前命名空间下找类,找不到就报Class 'App\Exceptions\PaymentException' not found - 写了
catch (Exception $e)却发现$e->getMessage()是空的 → 回头检查自定义类是否漏调parent::__construct() - 多个
catch块顺序写反(比如先catch (Exception)再catch (MyException))→ 子类永远进不去,因为父类先兜底了
自定义异常真正难的不是 throw,而是命名空间引用、构造转发、以及和现有 try/catch 结构的耦合细节——这些地方一错,异常就静默吞掉或直接崩掉。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











