Yii2通过ErrorHandler组件统一处理错误与异常，配置errorAction指向site/error动作以显示友好页面，结合YII_DEBUG与YII_ENV区分环境，生产环境关闭调试信息并记录日志，可自定义ErrorHandler类处理特定异常，提升安全性与可维护性。
Yii2 的错误与异常处理机制非常完善，通过内置的 ErrorHandler 组件统一管理 PHP 错误、异常以及 HTTP 状态码响应。合理配置错误处理不仅能提升开发效率，还能增强线上环境的安全性与用户体验。
启用和配置 ErrorHandler 组件
在 Yii2 应用中，ErrorHandler 是核心组件之一，默认已注册。你可以在应用配置文件（如 web.php 或 main.php）中进行自定义配置：
'components' => [
'errorHandler' => [
'errorAction' => 'site/error', // 指定错误页面对应的控制器动作
'maxSourceLines' => 20, // 显示代码上下文的最大行数
'maxTraceString' => 1024, // 调用栈信息最大长度
],
],
其中 errorAction 是关键配置项，表示当发生未捕获异常或 PHP 错误时，跳转到指定控制器的动作来显示友好错误页。
定义错误显示页面
通常将错误页面交给 SiteController 的 error 动作处理。确保该动作存在并正确渲染视图：
public function actions()
{
return [
'error' => [
'class' => 'yii\web\ErrorAction',
],
];
}
然后创建对应视图文件 views/site/error.php，根据环境判断是否显示详细错误信息：
<?php if (Yii::$app->errorHandler->exception) : ?>
<h1>发生错误</h1>
<p><?= htmlspecialchars($exception->getMessage()) ?></p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill9063" title="chartjs-reporter"><img
src="https://img.php.cn/upload/skill/000/000/081/179239514984446.jpg" alt="chartjs-reporter" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill9063" title="chartjs-reporter">chartjs-reporter</a>
<p>此技能用于在用户需要将结构化数据（查询结果、CSV 摘要、JSON 记录或 Python 字典/列表）转换为独立的 HTML 页面时使用。</p>
</div>
<a href="/xiazai/skill9063" title="chartjs-reporter" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div>
<?php endif; ?>
区分开发与生产环境的错误显示
为避免泄露敏感信息，应关闭生产环境的错误详情输出。可通过设置 YII_DEBUG 和 YII_ENV 控制行为：
defined('YII_DEBUG') or define('YII_DEBUG', false);
defined('YII_ENV') or define('YII_ENV', 'prod');
在生产环境中建议：
- 关闭 YII_DEBUG
- 不显示错误堆栈和文件路径
- 记录日志而非直接输出
自定义异常处理逻辑
若需对特定异常类型做特殊处理，可继承 ErrorHandler 并重写 handleException 方法：
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',
],
],
基本上就这些。合理利用 Yii2 的错误处理机制，既能保障调试效率，也能确保线上服务稳定安全。关键是根据环境调整输出策略，并善用日志记录问题。不复杂但容易忽略细节。
