xdebug 3 的 xdebug.output_dir 必须手动创建且确保 php 进程有写权限，否则 trace/profile 文件静默失败；它不自动创建路径，也不验证权限，常见于目录不存在、属主不符、selinux/apparmor 拦截或子配置覆盖等情况。
output_dir写入失败直接卡住调试启动
Xdebug 3 的 xdebug.output_dir 不只是“日志放哪”，它是所有 trace、profile、gcstats 等输出文件的根目录。如果这个路径不可写，Xdebug 会静默失败——不是报错退出，而是直接跳过日志生成，你根本看不到任何 trace 文件，也收不到错误提示。常见现象是：断点能进，但 profile 数据为空、trace 文件不生成、xdebug.log 里反复出现 ERROR: Could not open output directory（但默认不打这个日志，得开 xdebug.log 才能看到）。
必须手动创建目录并确保 PHP 进程有写权限
Xdebug 3 不会自动递归创建 output_dir 路径，哪怕你写了 xdebug.output_dir = "/var/log/xdebug"，如果 /var/log/xdebug 不存在或属主不是运行 PHP 的用户（如 www-data、apache、nginx），就会失败。这不是配置遗漏，是设计行为。
- 先用命令确认路径存在且可写：
sudo -u www-data mkdir -p /var/log/xdebug && sudo -u www-data touch /var/log/xdebug/test - Windows 下注意路径分隔符必须是反斜杠或双正斜杠：
xdebug.output_dir = "C:\tmp\xdebug"，单斜杠会被 PHP 解析为转义字符 - Docker 容器中要挂载宿主机目录并显式设权限，例如启动时加：
-v $(pwd)/xdebug-logs:/var/log/xdebug:rw,z，末尾的z是 SELinux 标签，不能省
xdebug.mode=profile/trace 启用后仍无文件？检查 output_dir 是否被其他配置覆盖
xdebug.output_dir 是全局日志根目录，但它会被更具体的配置隐式覆盖。比如你同时开了 xdebug.mode=profile,trace，但没设 xdebug.profiler_output_dir 或 xdebug.trace_output_dir，Xdebug 3 会 fallback 到 xdebug.output_dir；可一旦你写了其中任一子配置，它就只认那个值，xdebug.output_dir 就失效了。
Xdebug 3.4.1 是一款功能强大的 PHP 调试扩展工具，于 2025 年 1 月 6 日正式发布。作为 Xdebug 3.4 系列的首个修复版本，3.4.1 版在继承上一版本强大功能的同时，重点解决了稳定性问题。该版本不仅修复了访问超全局变量时可能引发的程序崩溃现象，还增强了对 Windows 平台 PIE 构建机制的支持，为广大 PHP 开发者提供了更加稳定的调试环境。这一版本适合所有
- 最简方案：只配
xdebug.output_dir，并确保xdebug.mode包含对应模式，如xdebug.mode=profile - 若需分离路径，必须显式配全：
xdebug.profiler_output_dir="/var/log/xdebug/profile"+xdebug.trace_output_dir="/var/log/xdebug/trace"，且两个路径都要提前建好、赋权 - PHP-FPM 场景下，
www-data用户可能被 chroot 或禁用了 home 目录，避免用~/tmp这类路径，一律用绝对路径
output_dir 权限问题常和 SELinux/AppArmor 强制策略冲突
Linux 服务器上即使 ls -l 显示目录属主正确、权限为 755，Xdebug 仍可能写失败。这是因为 SELinux（RHEL/CentOS）或 AppArmor（Ubuntu）阻止了 httpd/nginx 进程向非标准目录写日志。
- 临时验证：执行
sudo setenforce 0（SELinux）或sudo systemctl stop apparmor，再试一次。如果这时日志出来了，说明是策略拦截 - RHEL/CentOS 正确解法：
sudo semanage fcontext -a -t httpd_log_t "/var/log/xdebug(/.*)?"，然后sudo restorecon -Rv /var/log/xdebug - Ubuntu 正确解法：编辑
/etc/apparmor.d/usr.sbin.nginx，在{...}块内加一行/var/log/xdebug/** rw,，再sudo systemctl reload apparmor
Xdebug 3 的 output_dir 是个“信任但不验证”的配置项——它假定你已准备好路径和权限。实际部署时，90% 的日志缺失问题都卡在这一步，而不是 mode 设置或 IDE 配置。别跳过手动 touch 测试，也别依赖文档说“支持相对路径”就写 ./logs，PHP 进程的工作目录不等于你的项目根目录。
