监听 kernel.exception 事件是 symfony 统一处理异常的核心机制，需创建监听器类、实现 onkernelexception 方法、获取异常并设响应，再通过服务标签注册，支持优先级控制与多种业务场景响应。
监听 kernel.exception 事件是 Symfony 中统一捕获和处理异常的核心方式。它在请求生命周期中异常被抛出后、响应生成前触发，让你有机会拦截、记录、转换甚至替换响应。
创建异常监听器类
监听器需接收 GetResponseForExceptionEvent（Symfony 5.4+ 推荐用 ExceptionEvent），从中获取异常对象并操作响应：
- 定义一个普通 PHP 类，例如
src/EventListener/ExceptionListener.php - 方法签名必须匹配事件类型，如
public function onKernelException(ExceptionEvent $event) - 调用
$event->getException()获取原始异常 - 用
$event->setResponse($response)提前终止流程并返回自定义响应（如 JSON 错误或友好页面）
注册监听器到容器
通过服务标签声明为内核异常监听器，确保框架识别：
- 在
config/services.yaml中配置服务并打标签：
App\EventListener\ExceptionListener:
tags:
- { name: kernel.event_listener, event: kernel.exception, method: onKernelException }
- 若使用自动配置（默认开启），且类名含
ExceptionListener或方法命名规范，也可能被自动发现 - 可加
priority控制执行顺序（数字越大越先执行），避免被其他监听器覆盖响应
常见处理场景
根据业务需求灵活响应，不依赖全局错误页：
- API 异常标准化：对所有未处理异常返回统一 JSON 格式，含 code、message、timestamp
-
敏感异常降级：捕获
Doctrine\DBAL\Exception等，转为 503 服务不可用，不暴露数据库细节 - 日志与告警联动：记录异常堆栈到 Monolog，并触发 Sentry 上报或 Slack 通知
- 重定向兜底：在非 AJAX 请求中，将严重异常重定向至 /error 页面，保持用户会话
调试与验证技巧
监听器不生效？几个关键检查点：
- 运行
php bin/console debug:event-dispatcher kernel.exception --show-private查看是否注册成功 - 确认缓存已清除：
php bin/console cache:clear --env=dev - 检查异常是否在监听器执行前已被捕获（如中间件、控制器 try/catch 或前端代理）
- 加
-v参数运行命令或请求，查看完整异常堆栈，确认监听器是否被调用
