在 Symfony2 里制作独立的 404 静态页面，关键是让框架在找不到路由时，自动渲染一个纯 Twig 模板。

这个页面不走控制器，也不依赖任何业务逻辑。同时，还要确认 config.yml 里已经启用了 Twig 的异常处理器，最后通过访问一个不存在的 URL，检查页面是否按预期渲染。

在 Symfony2 中制作独立的 404 静态页面，核心是让框架在找不到路由时自动渲染一个纯 Twig 模板。

它不依赖控制器逻辑，也不触发业务代码。这个页面本质上是“错误视图”，需要放在约定路径下，并遵循命名规范，才能被异常处理器正确加载。

模板文件位置与命名

Symfony2 默认从 app/Resources/views/ 目录查找错误模板。

404 页面必须命名为 error404.html.twig。也可以使用更通用的 error.html.twig，但更推荐明确命名。

完整路径为：

• app/Resources/views/error404.html.twig

注意以下两点：

• 不能放在 templates/ 下，那是 Symfony 4+ 的结构
• 不能使用 Bundle 路径如 AcmeBundle:Exception:error404.html.twig，否则旧版内核无法识别

模板内容示例（简洁安全）

模板内容应保持纯静态展示，避免调用任何服务或数据库。

Twig 自动转义变量，但 404 模板通常不传参，因此直接写 HTML 即可：

抱歉，您访问的页面不存在
请检查网址是否正确，或返回 首页

说明：

• {{ path('homepage') }} 可用，因为 path 是 Twig 全局函数，不依赖控制器；确保 homepage 路由已定义
• 避免使用 {{ app.request.uri }} 或其他动态上下文，防止潜在错误或信息泄露
• 不引入 CSS/JS 文件时，无需 asset()；若需样式，可用内联 style 或绝对路径引用

确认异常配置生效

Symfony2 使用 TwigBundle 处理异常模板。

检查 app/config/config.yml 是否启用：

twig:
exception_controller: 'SymfonyBundleTwigBundleControllerExceptionController::showAction'

同时确保 kernel.exception 事件监听器正常工作。这个功能默认开启，一般无需改动。

测试方式很直接：手动访问一个不存在的 URL，例如 /nonexistent，观察是否渲染你写的 error404.html.twig。

缓存与调试注意事项

Twig 模板会编译缓存，位于 app/cache/dev/twig/ 或 app/cache/prod/twig/。

修改模板后，可按环境分别处理：

• 开发环境：清除缓存 php app/console cache:clear --env=dev
• 生产环境：需重新生成缓存，且确保 web 服务器有写权限
• 若仍显示默认错误页，检查日志 app/logs/dev.log 是否报 Unable to find template "error404.html.twig"，常见原因是路径错或文件名大小写不匹配（Linux 区分大小写）