Xdebug 3已安装可在phpinfo()查看但断点不触发且无日志输出

排查解决步骤 #

1. 日志无写入问题优先修复 #

• 先确认C:\xampp\tmp\xdebug\目录是否存在，Xdebug不会自动创建父目录，不存在请手动新建文件夹
• 右键该文件夹→【属性】→【安全】→编辑权限，给运行Apache的用户（或者直接给Everyone）赋予写入、修改权限，避免权限不足无法写日志
• 调整php.ini配置，去掉配置项值的多余引号：

  zend_extension = C:\xampp\php\ext\php_xdebug-3.0.4-7.4-vc15-x86_64.dll
  xdebug.mode = debug
  xdebug.start_with_request = no
  xdebug.client_port = 9003 
  xdebug.client_host = 127.0.0.1
  xdebug.log = C:\xampp\tmp\xdebug\xdebug.log
  xdebug.idekey = VSCODE
  

  改完重启Apache服务，再去phpinfo页面确认配置已生效。

2. 断点不命中问题排查 #

你的配置中xdebug.start_with_request = no默认不会自动开启调试，需要按场景主动触发：

• 浏览器调试网页场景：安装Xdebug Helper浏览器扩展，将扩展IDE Key设置为VSCODE，调试时点击扩展切换为调试模式，先在VSCode启动Listen for Xdebug调试配置，再刷新网页即可触发断点
• 本地脚本调试场景：直接在VSCode中选中要调试的php文件，启动Launch currently open script配置，即可自动触发调试命中断点
• 内置服务调试场景：启动Launch Built-in web server配置，访问自动弹出的页面地址即可触发调试

3. 其他常见问题排查 #

• 检查9003端口是否被占用：打开CMD执行netstat -ano | findstr "9003"，如果有其他进程占用，将php.ini的xdebug.client_port和launch.json中对应配置的port改为同一个未占用端口（比如9004），重启Apache后重试
• 确认调试启动顺序：必须先在VSCode启动对应调试配置监听端口，再发起PHP请求，否则Xdebug无法连接到IDE，不会触发断点也不会生成日志

内容的提问来源于stack exchange，提问作者a_fsd