PHP错误处理技巧与实战指南

PHP错误处理的核心陷阱在于：try/catch无法真正捕获传统Fatal error（如未定义函数调用），仅对PHP 7+中继承自Throwable的Error和Exception有效；要构建健壮的生产级错误防线，必须分层协作——用set_error_handler谨慎转化可接管的运行时警告为异常，用外层try/catch(Throwable)兜住所有Throwable子类并完整记录堆栈，严格禁用display_errors防止敏感信息泄露，同时厘清set_exception_handler与set_error_handler的职责边界，避免在catch/finally中引发二次崩溃；真正的难点不在于语法，而在于精准判断错误发生的位置、时机与拦截层级，否则日志里的“Uncaught TypeError”永远只是亡羊补牢的叹息。

怎么让 try/catch 真正捕获到 PHP 的致命错误

PHP 的 try/catch 默认不捕获 Fatal error（比如调用未定义函数、内存耗尽、类未找到），这是新手最常误以为“已兜底”却线上崩掉的原因。

真正能拦截的，只有继承自 Throwable 的异常和错误（PHP 7+）。但像 ParseError、TypeError、ArgumentCountError 这些是 Error 类的子类，属于 Throwable，可以被 catch (Throwable $e) 捕获；而传统 Fatal error（如 Call to undefined function）仍会直接终止脚本。

• 用 set_error_handler() + error_reporting() 配合，把部分 E_ERROR 级别错误转为异常（但不是全部，比如语法解析失败就做不到）
• 关键入口（如 CLI 脚本、Web 请求主流程）外层加 try/catch (Throwable $e)，并记录 $e->getMessage() 和 $e->getTraceAsString()
• 不要依赖 register_shutdown_function() 做“兜底日志”就以为稳了——它只能看到错误，不能阻止进程退出，也不能恢复执行

set_exception_handler() 和 set_error_handler() 怎么分工

二者定位不同：set_exception_handler() 处理未被捕获的 Exception 或 Throwable；set_error_handler() 处理 trigger_error() 或运行时警告/错误（E_WARNING、E_NOTICE 等），但对 E_ERROR 及以上默认无效（仅部分可接管）。

• set_error_handler() 必须返回 true 才能屏蔽原生错误输出，否则错误照打，handler 白注册
• 若同时用了 set_error_handler() 并想把某些错误转成异常，建议只转 E_WARNING、E_NOTICE、E_USER_*，别碰 E_ERROR——强行 throw 可能导致二次崩溃
• set_exception_handler() 中不要再抛异常，否则进程直接 exit，连日志都可能写不完

日志里为什么总看到 Uncaught TypeError 却没进 catch

因为这个错误发生在 try 块之外，或者发生在 catch 块内部又没被再次包裹。常见于：异步回调（如 array_map() 里的闭包）、构造函数中抛出、或 finally 里发生新错误覆盖了原异常。

• 检查 catch 是否写在了正确作用域——比如函数内 try，但错误实际发生在函数调用后返回值被使用时
• __construct() 抛出异常不会被父类构造函数的 try 捕获，必须在 new 表达式外层包 try
• 避免在 catch 或 finally 中调用可能失败的函数（如 file_put_contents() 写日志失败），否则原错误丢失，只剩新错误

生产环境要不要开 display_errors

不要。设为 Off 是底线，否则任何错误都会直接输出到响应体，可能泄露路径、数据库结构、甚至 token。

• display_errors = Off + log_errors = On + error_log = /var/log/php/error.log 是基础组合
• CLI 模式下可临时设 display_errors = Stderr，方便调试，但上线前必须关掉
• 框架项目（如 Laravel、Symfony）通常自带错误处理器，此时更要确认其配置没被 php.ini 的 display_errors 覆盖

错误处理最难的不是写 try/catch，而是搞清哪一层该由谁拦截、哪一层根本拦不住，以及日志里那条报错，到底是在哪个括号外面发生的。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《PHP错误处理技巧与实战指南》文章吧，也可关注golang学习网公众号了解相关技术文章。