根本原因是web服务器（如nginx/apache）提前拦截404，未将请求交由yii处理；需确保重写规则正确、enableprettyurl启用、errorhandler配置到位，并区分nginx兜底404与yii内部异常处理。
Yii 应用里 404 页面不显示自定义内容，只看到空白或默认 Nginx 页
根本原因是 Nginx 或 Apache 拦截了 404，根本没把请求交给 Yii 处理。Yii 的错误页面（如 site/error）只有在框架内部抛出 yii\web\NotFoundHttpException 时才会触发；如果 Web 服务器自己判定路径不存在并直接返回 404，Yii 压根不知道发生了什么。
解决方法分两层：
- 确保 Web 服务器把所有非静态资源请求都转给
index.php（Nginx 用try_files $uri $uri/ /index.php?$args;，Apache 用.htaccess中的RewriteRule） - 确认 Yii 的
urlManager已启用美化：enablePrettyUrl => true，否则/post/123这类路径进不来，直接被 Web 服务器判为 404 - 检查
config/web.php中是否配置了'errorHandler' => ['errorAction' => 'site/error']—— 缺这项，即使 Yii 抛出异常，也会回落到 PHP 默认错误页
为什么设置了 site/error，但 404 页面里拿不到 $exception->statusCode
因为 $exception 变量只在由 Yii 主动抛出异常时才完整可用。比如用户访问 /nonexistent，而该路由未定义，Yii 会抛 NotFoundHttpException，这时 $exception->statusCode 是 404；但如果控制器里手动写了 throw new \Exception('xxx')，它就不是 HTTP 异常，statusCode 为 0。
更常见的情况是：你期望显示 404，但实际渲染的是 500 页面。这是因为 site/error.php 视图本身出错（比如调用了不存在的 helper 方法），导致二次异常，最终 fallback 到最简错误页。
调试建议：
- 在
views/site/error.php开头加<?php var_dump($exception ?? null); die; ?>看实际传入对象 - 确认
$exception是yii\web\HttpException子类，才能安全调用getStatusCode() - 避免在 error 视图中使用未初始化的组件或依赖 layout 中可能失败的 asset bundle
Nginx 层面也想加一层兜底 404 页面，和 Yii 的怎么共存
可以共存，但必须明确分工：Nginx 的 error_page 404 /404.html 只处理「连 index.php 都没匹配到的请求」，比如直接访问 /favicon.ico 不存在、或 /css/missing.css 找不到；而 Yii 的 site/error 负责处理「请求进了 PHP，但路由/权限/逻辑层面失败」的场景。
关键点：
- Nginx 的
error_page必须放在location /块之外（通常在server块顶层），否则会被子 location 覆盖 - 确保你的静态资源 location（如
location ~* \.(js|css|png|jpg)$）**不带**try_files或fastcgi_pass，否则会错误地把 404 请求也转给 PHP - Yii 生成的 URL（如
Url::to(['post/view', 'id' => 1])）必须基于正确配置的urlManager，否则前端发出去的请求本身就带index.php，绕过美化规则，导致 Nginx 直接 404
自定义 500 页面时，Ajax 请求返回 HTML 而不是 JSON
Yii 默认对 Ajax 请求也渲染 HTML 错误页，这会导致前端 JS 解析失败。必须显式判断请求类型并切换响应格式。
最稳妥的做法是在 config/web.php 中重写 errorHandler 的 errorAction，或者继承 yii\web\ErrorHandler 并覆盖 renderException。但简单项目可直接在 site/error 视图开头加判断：
if (Yii::$app->request->getIsAjax()) {
Yii::$app->response->format = \yii\web\Response::FORMAT_JSON;
echo json_encode([
'code' => $exception->getCode(),
'message' => $exception->getMessage(),
]);
exit;
}
注意：$exception->getCode() 对 HTTP 异常（如 404、500）返回的是状态码；对普通 Exception 返回 0，需按需映射。
容易忽略的一点：如果用了自定义 ErrorAsset 或在 error 视图里加载了 JS/CSS，而这些资源路径又因美化配置错误返回 404，就会引发嵌套错误，让整个错误处理链失效。
