应抛出 notfoundhttpexception 而非手动返回404响应，以确保 symfony 异常处理机制统一接管日志、响应格式和环境行为；路由校验应通过 condition 或 kernel.request 监听器实现，而非控制器内判断。
控制器里不该“处理”404，而应主动抛出 NotFoundHttpException —— 这样才能让 Symfony 的异常处理机制统一接管，保证日志、响应格式、环境行为（如 dev 显示调试页）全部按预期工作。
在控制器中正确触发 404
不是返回 new Response('', 404)，也不是手动设状态码，而是抛异常。Symfony 会自动捕获它，并走完整的错误流程（包括渲染 error404.html.twig 或 JSON 响应，取决于监听器配置）。
- 用
throw new NotFoundHttpException('Resource not found');—— 最标准、最轻量的方式 - 若需携带上下文（比如查数据库没找到某 ID），可传入额外参数：
throw new NotFoundHttpException(sprintf('User %d not found', $id)); - 避免在
try/catch里吞掉异常再返回裸响应，否则会绕过所有全局异常监听逻辑（如 API 的 JSON 化、日志记录、监控埋点）
别在控制器里自己判断路由是否存在
控制器的职责是处理“已匹配到的请求”，不是做路由兜底。试图在 action 开头写 if (!$this->getRoute()) { throw ... } 是错的 —— 路由匹配发生在控制器执行前，根本不会进到这里。
- 404 只可能发生在两个环节：路由完全不匹配（
kernel.request阶段未找到 route），或控制器内业务逻辑发现资源不存在 - 前者靠 Symfony 自动处理；后者才该由你抛
NotFoundHttpException - 如果发现某个 URL 总是 404，先运行
php bin/console debug:router | grep your-path，确认路由是否注册成功，而不是改控制器
配合路由 condition 实现“校验失败即 404”
当需要基于 Header、Query 或 Host 做前置校验（比如只允许带 X-API-Key 的请求访问 /api/*），不要在每个控制器里重复写检查逻辑 —— 放到路由定义里更干净。
- YAML 路由中加
condition: "request.headers.has('X-API-Key')"，不满足时该路由直接不匹配，最终 fallback 到 404 - 注意 header 名会被转成小写，
request.headers.get('X-Api-Key')在 condition 里要写成request.headers.has('x-api-key') - condition 不支持复杂 PHP 表达式，如需调用服务或查 DB，请改用
kernel.request监听器，在里面校验并提前$event->setResponse(new Response('', 404))
真正容易被忽略的是：抛出 NotFoundHttpException 后，你写的自定义异常监听器（比如返回 JSON）是否设置了足够高的优先级（如 priority: 10）？否则它可能晚于默认监听器执行，导致你的逻辑被跳过。
