PHP的异常捕获规范注意事项有哪些

PHP异常捕获仅对Exception及其子类有效，无法捕获Warning、Notice或Fatal Error等Error体系错误；必须显式throw异常或由系统抛出如PDOException才能被catch；多个catch需按子类到父类顺序排列，PHP 8+支持多类型合并捕获；finally确保资源清理，空catch须至少记录日志。

PHP异常捕获不是“能抓就抓”，而是有明确边界和设计逻辑的。它只对 Exception 及其子类 有效，对 Warning、Notice、Fatal Error 等错误类型完全无感——这些属于 PHP 的 Error 类体系，与 Exception 平行，都实现 Throwable 接口，但语义和处理方式完全不同。

必须分清：哪些能 catch，哪些不能

能被 try-catch 捕获的只有显式抛出的异常对象：

• 手动 throw new Exception("...") 或自定义异常类实例
• 系统级异常：如 PDOException（数据库操作失败）、InvalidArgumentException（参数非法）、PHP 7.3+ 的 JsonException（启用 JSON_THROW_ON_ERROR 时）

以下情况 完全绕过 try-catch：

• file_get_contents("missing.txt") → 触发 E_WARNING，不抛异常
• 调用未定义函数 foo() → Fatal error: Uncaught Error，脚本立即终止
• 语法错误、内存耗尽、类未找到（Class not found）→ 全属 Fatal Error，catch 块根本不会执行

catch 块顺序与类型必须严谨

多个 catch 必须按 子类在前、父类在后 排列，否则具体异常会被泛化 catch 提前吞掉：

立即学习“PHP免费学习笔记（深入）”；

• ✅ 正确：catch (PDOException $e) → catch (RuntimeException $e) → catch (Exception $e)
• ❌ 错误：把 Exception 放最前，后面所有子类 catch 都失效
• PHP 8+ 支持单个 catch 捕获多类型：catch (PDOException | RuntimeException $e)，适合共用处理逻辑的场景

finally 不是可选项，而是资源安全底线

finally 块无论是否抛异常、是否被捕获，都会执行。这是释放资源不可替代的机制：

• 打开的文件句柄、数据库连接、临时锁、缓存标记等，必须在 finally 中显式关闭或清理
• 避免仅靠 catch 处理——如果没异常，catch 不执行，资源就泄漏了
• 注意：finally 中的 return 会覆盖 try 或 catch 中的返回值，慎用

空 catch 是危险信号，日志是最低要求

写 catch (Exception $e) { } 等同于主动屏蔽问题：

• 至少记录完整上下文：error_log($e->getTraceAsString(), 3, '/var/log/php/app.log');
• 生产环境禁止 echo $e->getMessage() 或直接输出堆栈，防止敏感路径/配置泄露
• 不要用异常做流程控制（比如用 throw 代替 if），这会让逻辑难以追踪