Symfony调试依赖工具链协同：debug-pack集成debug-bundle、profiler-pack和monolog-bundle，分别负责异常捕获、性能分析与日志管理，通过错误ID与请求ID联动实现问题快速定位。
Symfony调试不是靠猜，而是靠工具链协同工作。核心思路是：用对的工具查对的问题——错误就用symfony/debug，路由就用router:debug，安全配置就用security:debug，翻译缺失就跑translation:debug。
快速启用调试环境
确保项目处于开发模式是所有调试功能生效的前提：
- 检查.env文件中是否设置：
APP_ENV=dev和APP_DEBUG=1 - 若使用
debug-pack，执行：composer require --dev symfony/debug-pack - 清空缓存：
php bin/console cache:clear（开发环境下会自动跳过部分缓存）
按问题类型选调试命令
不用打开源码翻配置，直接终端一行命令就能看到真相：
-
查路由是否生效：运行
php bin/console router:debug，加--show-controllers可看绑定控制器；查单个路由加路由名，如app_api_users -
查防火墙和访问控制：运行
php bin/console security:debug，它会列出每个防火墙的匹配规则、提供者、入口点 -
查角色权限继承关系：运行
php bin/console security:role-hierarchy:dump，能清晰看到ROLE_ADMIN是否真的继承了ROLE_USER -
查翻译缺失或状态：运行
php bin/console translation:debug en --domain=messages，输出中MISSING或FALLBACK状态一目了然 -
查数据库查询性能：打开
/_profiler，点击“Database”选项卡，每条SQL附带参数、执行时间、调用栈
运行时变量与错误可视化
不打断流程也能看清数据，比var_dump更稳更准：
- 在任意PHP代码中写
dump($data)，支持数组、对象、资源，自动折叠、高亮、搜索 - 想立刻终止并查看：用
dd($data)，等价于dump($data); exit; - 捕获致命错误（如类不存在、函数未定义）：启用
symfony/debug后，FatalErrorException会被转成可捕获异常，还能看到完整堆栈和上下文 - 想集中查看所有
dump()输出（尤其AJAX或命令行任务中）：启动php Resources/bin/var-dump-server，再访问http://localhost:8000/_wdt即可聚合查看
进阶：用Introspector深挖组件内部
当标准命令不够用，比如OptionsResolver报错却不知默认值或类型限制在哪，就得动用“透视镜”：
- 创建
OptionsResolverIntrospector实例，传入你的OptionsResolver对象 - 调用
$introspector->getDefault('timeout')确认默认值是不是你预期的30 - 调用
$introspector->getAllowedTypes('format')验证是否只允许string和null - 调用
$introspector->getNormalizer('host')检查是否有自定义规范化逻辑影响了输入
