Yii2通过ErrorHandler组件统一处理错误与异常，配置errorAction指向site/error动作以显示友好页面，结合YII_DEBUG与YII_ENV区分环境，生产环境关闭调试信息并记录日志，可自定义ErrorHandler类处理特定异常，提升安全性与可维护性。
Yii2 的错误与异常处理机制非常完善，通过内置的
ErrorHandler
组件统一管理 PHP 错误、异常以及 HTTP
状态码
响应。合理配置错误处理不仅能提升开发效率，还能增强线上环境的安全性与用户体验。
启用和配置 ErrorHandler 组件
在 Yii2 应用中，
ErrorHandler
是核心组件之一，默认已注册。你可以在应用
配置文件
（如 web.
php
或 main.php）中进行自定义配置：
其中
errorAction
是关键配置项，表示当发生未捕获异常或 PHP 错误时，跳转到指定控制器的动作来显示友好错误页。
定义错误显示页面
通常将错误页面交给
SiteController
的
error
动作处理。确保该动作存在并正确渲染视图：
然后创建对应视图文件
views/site/error.php
，根据环境判断是否显示详细错误信息：
区分开发与生产环境的错误显示
为避免泄露敏感信息，应关闭生产环境的错误详情输出。可通过设置 YII_DEBUG 和 YII_ENV 控制行为：
在生产环境中建议：
关闭
YII_DEBUG
不显示错误堆栈和文件路径
记录日志而非直接输出
自定义异常处理逻辑
若需对特定异常类型做特殊处理，可继承
ErrorHandler
并重写
handleException
方法：
然后在配置中替换默认
处理器
：
基本上就这些。合理利用 Yii2 的错误处理机制，既能保障调试效率，也能确保线上服务稳定安全。关键是根据环境调整输出策略，并善用日志记录问题。不复杂但容易忽略细节。
'components' => [
'errorHandler' => [
'errorAction' => 'site/error', // 指定错误页面对应的控制器动作
'maxSourceLines' => 20, // 显示代码上下文的最大行数
'maxTraceString' => 1024, // 调用栈信息最大长度
],
],
public function actions()
{
return [
'error' => [
'class' => 'yii\web\ErrorAction',
],
];
}
errorHandler->exception) : ?>
发生错误
getMessage()) ?>
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。
下载
defined('YII_DEBUG') or define('YII_DEBUG', false);
defined('YII_ENV') or define('YII_ENV', 'prod');
class CustomErrorHandler extends \yii\base\ErrorHandler
{
public function handleException($exception)
{
if ($exception instanceof CustomException) {
Yii::warning('捕获自定义异常：' . $exception->getMessage());
// 可跳转到特定页面或返回 JSON 响应
}
parent::handleException($exception);
}
}
'components' => [
'errorHandler' => [
'class' => 'app\components\CustomErrorHandler',
'errorAction' => 'site/error',
],
],