hyperf中重写exception类本身不会直接报错，但若破坏继承链、未实现throwable接口关键方法、在构造函数中调用容器服务或触发i/o，将导致fatal error或启动失败；必须继承exception/runtimeexception，禁用覆盖原生exception类。
Hyperf 中重写 Exception 类本身不会直接导致代码运行错误，但若操作不当（如破坏异常继承链、未正确实现关键方法、或在异常处理流程中引入循环依赖），就容易触发致命错误（如 Fatal error: Uncaught Error 或服务启动失败）。
确保继承自 PHP 原生 Exception
Hyperf 基于 Swoole 和 PHP 长生命周期运行，所有自定义异常必须严格继承 Exception 或其子类（如 RuntimeException）。禁止继承其他非异常类，也不应“替换”全局 Exception 类名。
- ✅ 正确写法：
class MyException extends Exception {} - ❌ 错误写法：
class Exception extends RuntimeException {}（覆盖原生类，PHP 禁止且会崩溃） - ❌ 错误写法：
class MyException implements Throwable（缺少必要方法，Hyperf 异常处理器无法识别）
避免在异常类中触发新异常或依赖容器
自定义异常的构造方法（__construct）应在最简状态下完成初始化。Hyperf 的异常捕获发生在容器已启动但部分服务可能尚未就绪的阶段，此时调用 ApplicationContext::getContainer() 或访问配置、日志等，极易引发循环依赖或 Container is not initialized 错误。
- 不要在
__construct中调用logger()、config()或任何需容器解析的服务 - 如需携带上下文信息，用普通属性赋值（如
$this->traceId = $traceId;），延迟到异常被真正处理时再使用 - 避免在异常类中触发数据库查询、HTTP 请求等 I/O 操作
正确注册全局异常处理器
Hyperf 不通过重写 Exception 类来接管异常，而是通过 ExceptionHandler 机制。你需要：① 创建继承 ExceptionHandler 的处理器类；② 在 config/autoload/exceptions.php 中注册；③ 确保该处理器能匹配你抛出的自定义异常类型。
- 示例处理器：
class MyExceptionHandler extends ExceptionHandler - 注册方式：
MyException::class => MyExceptionHandler::class（注意键名为异常类全限定名） - 检查是否拼错命名空间，或忘记在
exceptions.php中 return 数组
启动时报错？优先检查 composer autoload 和 PSR-4 映射
如果修改异常类后 Hyperf 启动直接报 Class not found 或 Cannot declare class，大概率是自动加载问题：
- 确认类文件路径与命名空间完全一致（如
App\Exception\MyException必须位于app/Exception/MyException.php） - 运行
composer dump-autoload刷新自动加载映射 - 检查是否有两个同名类被不同 PSR-4 规则加载（常见于复制粘贴后未改类名）
- 临时注释掉异常抛出代码，验证是否为类定义本身导致启动失败
