必须逐层验证环境、路由、模板注入和IP白名单：确认APP_ENV=dev且APP_DEBUG=1，kernel.debug为true，WebProfilerBundle已注册，_profiler路由存在，模板含{{ render_profiler() }}，security.yaml配置pattern: ^/_profiler，并设置ip_whitelist。
要在 Symfony 7.1 中创建可落地的性能监控，必须让 Web Profiler 正常采集数据并能稳定访问调试界面——不是装完包就自动生效，而是要逐层验证环境、路由、模板注入和 IP 白名单是否全部就位。
确认开发环境与 Profiler 包已就绪
执行 php bin/console about，检查输出中 Environment 显示为 dev，Flex 显示为 enabled；若未安装 profiler 包，运行 composer require --dev symfony/web-profiler-bundle。
打开 .env 文件，确保包含且仅包含这两行：
APP_ENV=dev
APP_DEBUG=1
【APP_DEBUG 必须为 1，设成 true 或 on 都无效】
运行 php bin/console debug:container --parameter=kernel.debug，输出必须是 true。若为 false，说明 .env 被覆盖（如存在 .env.local），需检查并修正。
注册 Bundle 并验证路由可用
打开 config/bundles.php，确认存在以下条目：
Symfony\Bundle\WebProfilerBundle\WebProfilerBundle::class => ['dev' => true, 'test' => true]
执行 php bin/console debug:router | grep _profiler，应看到至少三条路由：_profiler.home、_profiler.search、_profiler.info。若无输出，说明路由未加载。
此时需检查 config/routes/dev/web_profiler.yaml 是否存在。若缺失，手动创建该文件，写入：
web_profiler:
resource: '@WebProfilerBundle/Resources/config/routing.xml'
注入 Toolbar 并放开访问控制
打开主 Twig 模板（通常是 templates/base.html.twig），在 </body> 标签前插入：
{{ render_profiler() }}
编辑 config/packages/security.yaml，在 firewalls 下的 dev 防火墙中添加：
pattern: ^/_profiler
若部署在本地但通过 Nginx 或 Docker 访问，还需配置 IP 白名单：
framework:
web_profiler:
ip_whitelist: ['127.0.0.1', '::1', '172.16.0.0/12']
【不配白名单时，Docker 容器内请求会被直接拒访】
启动服务并验证数据采集
第一步：启动内置服务器 → php -S localhost:8000 -t public
第二步：浏览器访问 http://localhost:8000，页面底部应出现黑色工具栏。
第三步：打开浏览器开发者工具 → Network 标签 → 刷新页面 → 找到任意一个响应头含 X-Debug-Token 的请求 → 复制其值（如 abc123）→ 访问 http://localhost:8000/_profiler/abc123。能打开即表示 Profiler 数据已成功采集。
