Profiler和工具栏需APP_ENV=dev且APP_DEBUG=1，WebProfilerBundle启用，响应未被截断；CLI需手动启用并构造请求/响应对象；数据滞后应清空var/cache/dev/profiler/。
工具栏和Profiler不是“装了就能用”的功能，它们依赖 kernel.debug 参数在启动时就为 true，且必须运行在 dev 环境下；任一条件不满足，页面底部就不会出现 <script id="sfwdt"></script>，后续所有分析都无从谈起。
确认 Profiler 和工具栏已真正启用
很多人改了 .env 就以为完事了，其实关键判断点在 Kernel 初始化阶段。检查三件事：
-
APP_ENV=dev且APP_DEBUG=1已设在.env文件中（不是只在 config 中配） -
config/bundles.php里Symfony\Bundle\WebProfilerBundle\WebProfilerBundle::class => ['dev' => true]这行存在 - 访问页面后，查看 HTML 源码末尾——必须有
<script id="sfwdt"></script>，没有就说明中间件根本没跑
常见静默失败原因：用了 ob_end_clean()、模板里写了 exit、响应被提前输出、或 Nginx 配置了 gzip 但 PHP 没开 zlib.output_compression。
点击工具栏图标进入对应 Profiler 页面
工具栏每个图标对应一个核心维度，点击后跳转到该次请求的完整分析页（URL 形如 /_profiler/{token}）。重点关注：
-
200 OK图标：点它进 Overview，看总耗时、SQL 查询数、Twig 渲染次数是否异常飙升 -
DB图标：进 Doctrine 标签页，找标红的 “N+1 queries” 或 “Slow query (>100ms)” 提示 -
⏱️图标：进 Timeline，拖动时间轴看哪一段卡住——比如controller.action耗时长，说明业务逻辑有问题；twig.template占比高，可能是模板嵌套太深或未缓存 -
❗图标：进 Logs，筛选doctrine或security通道，快速定位权限拒绝或查询空结果的上下文
注意：Profiler 数据是按请求存储的，刷新页面会生成新 token；想对比登录前后差异，用右上角 Switch Profiler 功能。
CLI 场景下手动触发 Profiler 数据采集
命令行、消息消费者、单元测试默认不走 HTTP 流程，Profiler 不会自动激活。必须手动调用：
$profiler = $this->getContainer()->get('profiler');
$profiler->enable();
$stopwatch = $this->getContainer()->get('stopwatch');
$stopwatch->start('my_command');
// ... 执行你的逻辑 ...
$stopwatch->stop('my_command');
$profiler->collect($request, $response, $exception);
要点：
-
$request和$response需构造（可用new Request()和new Response()），$exception可为null - 必须先
start()再stop()，否则 Timeline 为空 - 采集后的数据存进
var/cache/dev/profiler/，之后可通过php bin/console profiler:search "command=my_command"查找 token
别指望 dump() 在 CLI 里显示在工具栏里——它只会打到终端，这是设计如此。
为什么工具栏数据没更新？清缓存只是第一步
改了代码但工具栏还是旧数据，往往不是缓存没清，而是 Profiler 的底层存储机制被干扰了：
-
var/cache/dev/profiler/目录权限不对（如 www-data 无法写入），Profiler 会静默放弃保存，工具栏变灰且无提示 - 磁盘满了，或
opcache.restrict_api限制了 Profiler 的模板编译路径 - 你改了
framework.profiler.storage.dsn想切 Redis，但没装symfony/cache或驱动不匹配，结果数据全丢了
最稳的做法：保持默认文件存储，确保 var/cache/dev/profiler 可写，每次怀疑数据滞后时，先 rm -rf var/cache/dev/profiler/* 再刷新，比反复 cache:clear 更直接有效。
