Symfony 2 中替换 404 页面需在 app/Resources/views/Exception/ 下创建 error404.html.twig，开发环境默认不渲染需调优配置，并注意 API 请求需逻辑层分流处理 JSON 错误。
在 Symfony 2 中，替换原生 404 页面不能靠简单放个模板文件就生效——它没有 Laravel 那样的 resources/views/errors/404.blade.php 自动约定机制。Symfony 2 的错误页面由 Twig 模板 + 异常监听器共同控制，需手动配置视图路径并确保环境与渲染逻辑匹配。
确认错误模板存放位置和命名规范
Symfony 2 默认使用 app/Resources/views/Exception/ 目录下的 Twig 模板处理 HTTP 异常。你需要在此目录下创建：
-
error404.html.twig（对应 404） -
error.html.twig（兜底模板，用于未明确匹配的状态码）
注意：文件名必须是 error404.html.twig，不是 404.html.twig 或 not_found.html.twig；扩展名必须是 .html.twig；路径必须严格为 app/Resources/views/Exception/（不是 src/AppBundle/Resources/views/ 或 web/ 下）。
确保开发环境也能看到自定义页（关键调试点）
Symfony 2 在 debug: true（即开发环境）下默认显示完整异常堆栈，不渲染 error404.html.twig——这是设计行为，不是 bug。但你可以临时绕过：
PigX UI Pro 前端开发指南 - Vue 3 + TypeScript + Element Plus。当用户提到 PigX UI、PigX 前端、lgb-mgui 项目、Vue 3 企业级后台开发、Element Plus 后台开发时使用此技能。
立即学习“前端免费学习笔记（深入）”；
- 修改
app/config/config_dev.yml，注释或删除framework: exception_listener相关配置（如果存在） - 或更稳妥的方式：在
app/config/config.yml中统一配置异常模板，并将debug设为false测试（如本地用php app/console server:run --env=prod） - 验证前务必清缓存：
php app/console cache:clear --env=prod
强制触发并接管 404 渲染流程
Symfony 2 不会自动根据状态码选模板，需靠 Twig 命名约定 + 内置异常控制器配合。确保以下两点成立：
- 你的
app/config/routing_dev.yml中没有覆盖或禁用SensioDistributionBundle的异常路由（该 Bundle 提供/_error/{code}路由用于调试） - 模板中不要依赖
$status_code或$status_text等变量——Symfony 2 的error404.html.twig接收的是exception对象，可用{{ exception.statusMessage }}或{{ exception.statusCode }}获取信息 - 若想复用同一套 HTML 结构，可在
error404.html.twig中 extends 主布局，但需确保 layout 文件在app/Resources/views/下且路径正确
避免被空白响应或 JSON 接口干扰
前端页面 404 替换只对 HTML 请求生效。如果你的项目混用了 API 接口（如 AJAX 请求返回 404），它们通常返回 JSON，不会走 Twig 模板。此时需额外处理：
- 检查请求头：
Accept: application/json时，应返回 JSON 错误结构，而非跳转到 404 页面 - 在控制器或事件监听器中判断
$request->isXmlHttpRequest()或$request->getMimeType($request->getRequestFormat()) === 'json'，分流处理 - 不要指望
error404.html.twig能覆盖 API 场景——那是逻辑层职责，不是视图层能解决的
