Webgrind 显示“No runs found”需三步排查：一是确保 xdebug.profiler_output_dir 与 Webgrind $storageDir 绝对路径完全一致；二是启用触发模式（xdebug.profiler_enable=0 + profiler_enable_trigger=1），通过 ?XDEBUG_PROFILE 访问；三是文件名必须为 cachegrind.out.*、权限可读且 dot 命令已安装。
Xdebug 配合 Webgrind 不是“开箱即用”的可视化方案，必须手动对齐文件格式、路径权限和触发机制，否则 Webgrind 页面永远显示 “No runs found” 或空白列表。
确认 xdebug.profiler_output_dir 和 Webgrind 的 $storageDir 完全一致
这是最常被忽略的硬性前提：Webgrind 不会自动猜路径，它只扫描 $storageDir 下以 cachegrind.out. 开头的文件。两者不一致，就等于把报告写进 A 目录，却让 Webgrind 去 B 目录翻找。
- 用
php --ini找到生效的配置文件，检查xdebug.profiler_output_dir值（例如/tmp/xdebug） - 打开 Webgrind 的
config.php，确认static $storageDir = '/tmp/xdebug';（注意末尾无斜杠，且是绝对路径） - 确保该目录存在、可写，且属主与 PHP-FPM 进程用户一致（常见错误：
chown www-data:www-data /tmp/xdebug或chown nginx:nginx /tmp/xdebug） - 别用
~或相对路径——static $storageDir = '~/xdebug'会静默失败
必须用 ?XDEBUG_PROFILE 触发 Profiler，不能靠 xdebug.profiler_enable=1
设 xdebug.profiler_enable=1 会让每次请求都生成 cachegrind 文件，线上环境极易撑爆磁盘或拖慢响应；而 Webgrind 默认只读取最新一个文件，容易误判为“没数据”。推荐始终启用触发模式。
- 在 php.ini 或 xdebug.ini 中设
xdebug.profiler_enable=0和xdebug.profiler_enable_trigger=1 - 访问目标 URL 时显式加参数：
http://localhost/app/index.php?XDEBUG_PROFILE - 刷新后立刻去
xdebug.profiler_output_dir下检查是否生成了新文件（如cachegrind.out.123456），没有则说明触发未生效 - 如果用 Nginx + PHP-FPM，确认
fastcgi_param QUERY_STRING $query_string;已配置，否则参数无法透传给 PHP
Webgrind 页面点击 Update 后仍无数据？检查文件名和权限
Webgrind 对文件名有隐式约定，且不报错提示。即使路径对了，名字不对或权限不足也会静默跳过。
立即学习“PHP免费学习笔记（深入）”；
- 文件名必须以
cachegrind.out.开头（注意大小写和点号），xdebug.profiler_output_name=cachegrind.out.%p是安全选择；out.%t或profile.%R等自定义格式可能导致 Webgrind 扫描不到 - 用
ls -l /tmp/xdebug/看文件属主和权限，PHP 进程用户（如www-data）必须能read这些文件 - 如果文件是 root 写的，但 Webgrind 由 nginx 用户运行，就会读不到——建议统一用 PHP-FPM 的 user/group 创建并写入
- 临时调试可用
chmod 644 /tmp/xdebug/cachegrind.out.*排除权限干扰（上线前务必改回）
Call Graph 显示为空或报错 dot not found？不是 Webgrind 的问题
Webgrind 的调用图依赖系统级命令 dot（来自 graphviz），它不内置、不打包、也不报红字错误，只默默禁用按钮。
- 先运行
which dot，确认已安装 graphviz（apt install graphviz或brew install graphviz） - 编辑 Webgrind 的
config.php，找到static $dotExecutable = '/usr/bin/dot';，替换成which dot输出的真实路径 - 如果系统中
dot在/usr/local/bin/dot，但 Webgrind 默认查/usr/bin/dot，就会失效 - 无需改 Python 路径——新版 Webgrind（v1.9+）已移除 Python 依赖，只用
dot
真正卡住人的地方，从来不是“怎么装”，而是“为什么没数据”——绝大多数失败发生在路径拼错、权限不匹配、文件名不合规这三处，且 Webgrind 不给你任何提示。动手前，先 ls -l 和 which dot 两行命令，比重装十次都管用。
