Yii2中setStatusCode()不生效主因是响应头已发送或被覆盖，应优先抛出NotFoundHttpException；REST接口自动转JSON，需通过errorHandler配置自定义错误响应。
Yii2 中 response->setStatusCode() 不生效的常见原因
直接调用 Yii::$app->response->setStatusCode(404) 后页面仍返回 200，通常不是函数错了，而是响应头已发送或后续逻辑覆盖了状态码。Yii 的 response 对象是延迟写入的，但一旦 echo、var_dump、输出缓冲被清空，或者视图已开始渲染，再改状态码就无效了。
实操建议：
- 确保在控制器 action 开头或
beforeAction()中设置，避免在render()或echo之后调用 - 检查是否有其他组件（如日志、调试工具条）提前触发了输出；可在入口脚本开头加
ob_start()临时排查 - 若用了 RESTful 模块（如
yii\rest\Controller），它会自动根据异常类型设状态码，手动设可能被覆盖
用 throw new NotFoundHttpException() 实现标准 404 跳转
这是 Yii 推荐方式，不靠手动设状态码，而是抛出预定义异常，由全局错误处理器统一处理。它不仅设 404 状态码，还会渲染 @app/views/site/error.php（或自定义错误页），且兼容调试/生产环境切换。
常见错误现象：抛出异常后页面空白、或跳到默认 Apache/Nginx 404 页——说明应用级错误处理器没接管，通常是 catchAll 配置或 errorHandler 组件被禁用/覆盖。
使用场景：
- 查不到数据库记录时：
if (!$model) throw new NotFoundHttpException('ID 不存在'); - 路由存在但资源不可访问（如权限校验失败）也可复用，但语义上更推荐
ForbiddenHttpException - REST API 中，该异常会自动序列化为 JSON 并带
"name": "Not Found"字段
自定义 404 响应内容（JSON / HTML / 重定向）
Yii 默认返回 HTML 错误页，但 API 场景需要 JSON，或想重定向到首页，就得干预错误处理器行为。关键不在 response，而在 errorHandler 配置和 errorAction 视图逻辑。
实操建议：
- 在
config/web.php中配置：'errorHandler' => ['errorAction' => 'site/error']，然后在SiteController::actionError()里判断Yii::$app->errorHandler->exception类型 - API 场景下，可在此 action 中检查
Yii::$app->request->getIsAjax() || Yii::$app->request->getIsJsonp()，然后手动return $this->asJson([https://www.php.cn/link/263b1243ca2dbeb358777ceabc4a2e4c]) - 绝对不要在
actionError里再 throw 异常，会导致递归崩溃；重定向用$this->redirect(['site/index'])->send()+exit
Response 重定向与 404 的混淆点
有人试图用 Yii::$app->response->redirect(['site/error'], 404) 实现 404，这是错的。redirect() 发送的是 302（或指定的 3xx）状态码，不是 404；浏览器会跳转，服务端返回的仍是 302，SEO 和 API 客户端都会误判。
真正需要“跳转式 404”（比如旧 URL 迁移后告知用户并引导），正确做法是：
- 先设状态码：
Yii::$app->response->setStatusCode(404) - 再输出提示页或 JSON，并明确告诉用户“该页面已下线，前往 新地址”
- 如果必须跳转（如 SEO 要求），应返回 301/302 + Location 头，而非伪装 404
容易被忽略的是：HTTP 状态码和页面内容是两件事。404 是告诉客户端“找不到”，不是“请换个地址找”。混用会破坏接口契约，尤其对爬虫和自动化工具。
