Symfony2批量拦截非法路由统一输出404页面-php教程-PHP中文网

symfony 2 中应通过监听 kernel.exception 事件接管 notfoundhttpexception，按 accept 头返回 json 或 html 格式 404 响应，确保路由 strict_requirements 为 true，并用兜底路由防止非法路径误匹配，最后验证 api 和浏览器访问的 404 行为是否符合预期。

symfony2批量拦截非法路由统一输出404页面

在 Symfony 2 中，无法靠“全局 404 页面”掩盖路由匹配失败问题——真正要做的，是让所有未定义的路由路径（即无匹配路由）统一返回标准 404 Not Found 响应，并确保响应格式与你的 API 或前端契约一致（比如 JSON 或 HTML），而不是暴露默认调试页或空白错误。

明确 404 的触发边界：不是所有“找不到”都该归你处理

Symfony 路由系统本身已在内核层面处理了“无匹配路由”的情况：当请求 URL 完全不匹配任何已注册路由时，内核会自动抛出 NotFoundHttpException，并最终由异常监听器或默认逻辑转为 404 响应。你不需要手动遍历所有非法路径，也不该用正则批量拦截；重点是确保这个默认行为不被覆盖、不被绕过、响应体可控。

不要在控制器里 catch NotFoundHttpException 并自行 return new Response(‘404’, 404) —— 这破坏语义，丢失 HTTP 头（如 X-Content-Type-Options）和环境适配（开发/生产不同展示）
不要用 kernel.request 事件提前判断路径并 redirect 或 throw —— 路由匹配尚未发生，此时判断不可靠，且易引发循环或误判
确保 framework.router.strict_requirements 设为 true（默认），这样参数约束失败（如 {id} 要求数字但传了 abc）也会触发 404，而非 500

统一输出 404 响应体：按 Accept 头动态适配格式

关键不是“拦截”，而是“接管”。监听 kernel.exception 事件，在捕获 NotFoundHttpException 时，根据请求头决定返回 JSON 还是 HTML，避免前端 App 拿到 HTML 页面而崩溃。

Skill Weave Chains — 技能链路由引擎

开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。

下载

检查 $request->getAcceptableContentTypes() 是否包含 application/json；若是，返回结构化 JSON：{"error": "not_found", "message": "Resource not found"}
若接受 HTML（如浏览器直接访问），可复用 Symfony 默认的 404 模板（templates/bundles/TwigBundle/Exception/error404.html.twig），无需重写
确保该监听器优先级足够高（如 priority: 16），避免被其他监听器抢先处理并覆盖响应

防止非法路径被意外匹配：路由定义要收口

有些“非法路由”其实已被模糊路由捕获，比如用了通配符 {_locale} 或 {slug} 却没加约束，导致 /api/xxxxx 匹配到某个泛用控制器并抛出业务异常（如 500）。这不是 404，但用户感知一样。

对所有带通配符的路由，显式添加 scheme、host、requirements 约束，例如：requirements: { id: '\d+' }

在 routing.yml 底部追加兜底路由（仅限 prod 环境），匹配任意路径并强制 404：

catch_all:<br>  path: /{any}<br>  defaults: { _controller: 'FrameworkBundle:Template:template' }<br>  options: { expose: false }<br>  requirements: { any: '.*' }<br>  condition: "context.getMethod() === 'GET' and request.isXmlHttpRequest() === false"

再配合一个空模板或直接 throw new NotFoundHttpException()，确保它不干扰正常路由

验证是否生效：两个必测场景

部署后立即验证，避免上线才发现“非法路径返回了 500 或空白”：

用 curl 测 API：curl -H "Accept: application/json" http://yoursite.com/api/nonexistent → 应返回 JSON + 404 状态码
用浏览器访问：http://yoursite.com/some-random-path → 应显示定制的 404 页面（非 Symfony 黄页，也非空白）
检查日志：var/logs/prod.log 中对应请求应有 request.ERROR: Uncaught PHP Exception Symfony\Component\HttpKernel\Exception\NotFoundHttpException 记录，说明确实走到了标准流程