必须确保五个环节全部连通：一是.env中APP_ENV=dev且APP_DEBUG=1；二是php bin/console about显示Environment=dev、Flex=enabled；三是composer show验证symfony/web-profiler-bundle已安装；四是bundles.php注册WebProfilerBundle且debug:router含_profiler路由；五是模板注入{{ render_profiler() }}并页面源码存在<script id="sfwdt">。
要在开发中实时查看HTTP请求详情、数据库查询耗时、Twig渲染次数等调试数据，必须让WebProfiler工具栏出现在页面底部并能点击跳转到完整分析界面。这需要五个环节全部连通，缺一不可。
确认开发环境与Bundle安装状态
第一步：检查.env文件，确保包含APP_ENV=dev和APP_DEBUG=1两行——【这两项必须同时存在且写在.env中，不能只在YAML里配debug: true】。
第二步：运行php bin/console about，确认输出中Environment字段为dev，Flex字段为enabled。
第三步：执行composer show symfony/web-profiler-bundle。若提示未找到包，则运行composer require --dev symfony/web-profiler-bundle安装。
注册WebProfilerBundle并验证路由
打开config/bundles.php，确认存在以下注册项：
Symfony\Bundle\WebProfilerBundle\WebProfilerBundle::class => ['dev' => true, 'test' => true]
若缺失，请手动添加并保存。此步骤不生效，整个工具将完全静默。
运行php bin/console debug:router，查找是否输出以_profiler开头的路由。若无结果，需检查config/routes/dev/web_profiler.yaml是否存在；如不存在，创建该文件并填入：
web_profiler: resource: '@WebProfilerBundle/Resources/config/routing.xml'
注入Toolbar脚本并验证HTML响应
打开主模板（通常是templates/base.html.twig），在</body>标签前插入：
{{ render_profiler() }}
这一步漏掉，页面底部就绝不会出现黑色工具栏——新版骨架默认已含，但自定义模板常被删掉。
启动服务器：php -S localhost:8000 -t public，访问任意页面后，右键→“查看页面源代码”，搜索<script id="sfwdt">。没有这个标签，说明响应被ob_end_clean()、exit或未捕获的致命错误截断了。
检查IP白名单与安全配置
方法一：确认config/packages/dev/web_profiler.yaml中存在如下配置：
framework: web_profiler: ip_whitelist: ['127.0.0.1', '::1']
方法二：若使用Nginx或远程开发机，需将实际客户端IP加入ip_whitelist，否则会返回403 Forbidden。
方法三：检查config/packages/security.yaml中access_control段，确保包含类似规则：
- { path: ^/_profiler, role: IS_AUTHENTICATED_ANONYMOUSLY }
