symfony 2 中控制器抛出 404 异常的标准写法是 throw new notfoundhttpexception('消息')，需 use symfony\component\httpkernel\exception\notfoundhttpexception；该方式被框架异常机制识别，可触发 kernel.exception 事件并统一渲染 html/json 响应。

在 Symfony 2 中，控制器内主动抛出 404 异常的标准写法是抛出 HttpNotFoundException（来自 Symfony\Component\HttpKernel\Exception），而不是直接 throw new \Exception() 或 return new Response('', 404)。

使用 HttpNotFoundException 类

这是 Symfony 官方推荐且框架内置识别的方式，能被默认的异常处理机制（如 exception_controller）正确捕获并渲染为 404 页面或 JSON 响应（取决于请求格式）。

• 需引入命名空间：use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
• 在控制器方法中直接 throw new NotFoundHttpException('资源未找到');
• 该异常继承自 HttpException，状态码自动设为 404，无需手动指定

避免常见错误写法

以下方式虽能返回 404 状态，但不符合 Symfony 2 的异常处理规范，会导致监听器失效、日志不统一、API 响应格式异常等问题：

Symfony Linux版

Symfony Linux版整理 Symfony CLI 5.17.1 官方下载入口和 Symfony 框架安装配置说明。

下载

• return new Response('Not Found', 404); —— 绕过异常系统，无法触发 kernel.exception 事件
• throw new \RuntimeException('404'); —— 无 HTTP 语义，不被 HttpKernel 识别为客户端错误
• throw new \Exception('404'); —— 同样缺乏上下文和状态码绑定，调试困难

配合 exception_controller 实现统一响应

确保 app/config/config.yml 中已启用异常控制器（Symfony 2 默认开启）：

• framework: exception_controller: 'AcmeDemoBundle:Exception:show'
• 这样 NotFoundHttpException 会被路由到指定控制器，自动区分 HTML / JSON 请求并返回对应格式（如 Accept: application/json 时返回 {"error":"Not Found"}）

业务场景中的合理用法

典型用于资源查找失败，例如从数据库或外部 API 获取数据后判断不存在：

• $post = $em->find('Post', $id);
• if (!$post) { throw new NotFoundHttpException(sprintf('Post with id %s not found', $id)); }
• 消息中包含关键参数（如 ID），便于日志追踪和前端提示