Windows10下浏览器无法请求VSCode的Xdebug服务器问题排查

问题背景 #

此前在Mac环境使用Xdebug正常，现迁移至Windows 10，安装Xdebug 2.9.8并完成配置后，php -v已确认Xdebug安装成功，VSCode的php-debug扩展也已安装。调试当前脚本、php-debug自动配置的内置服务器均正常，但VSCode的「Listen for Xdebug」功能失效，请求Apache虚拟主机hello.localhost时无法触发调试。

现有配置 #

php.ini 配置 #

; XDEBUG Extension
[xdebug]
zend_extension = c:\wamp64\bin\php\php7.1.33\ext\php_xdebug.dll
xdebug.remote_enable = on
xdebug.profiler_enable = off
xdebug.profiler_enable_trigger = Off
xdebug.profiler_output_name = cachegrind.out.%t.%p
xdebug.profiler_output_dir ="c:/wamp64/tmp"
xdebug.show_local_vars=0
xdebug.remote_host='127.0.0.1'
xdebug.remote_port=9003
xdebug.log="c:/wamp64/logs/xdebug.log

Apache 虚拟主机配置 #

<VirtualHost *:80>
  ServerName hello.localhost
  DocumentRoot "${INSTALL_DIR}/www/hello"
  <Directory "${INSTALL_DIR}/www/hello/">
    Options +Indexes +Includes +FollowSymLinks +MultiViews
    AllowOverride All
    Require local
  </Directory>
</VirtualHost>

VSCode 调试配置 #

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Listen for Xdebug",
      "type": "php",
      "request": "launch",
      "port": 9003
    }
  ]
}

排查与修复步骤 #

• 修复php.ini语法错误：
  最后一行xdebug.log="c:/wamp64/logs/xdebug.log缺少闭合双引号，修正为xdebug.log="c:/wamp64/logs/xdebug.log"，语法错误会导致Xdebug配置不生效。

• 补充Xdebug远程触发配置：
  在php.ini中添加以下配置：

  xdebug.remote_autostart = on
  xdebug.remote_connect_back = off
  

  xdebug.remote_autostart=on可让每次请求自动触发调试，无需手动添加XDEBUG_SESSION参数；若不需要自动触发，可保持off，配合浏览器Xdebug helper插件手动开启调试会话。

• 验证端口与防火墙：
  确认Windows防火墙未拦截9003端口，或未阻止Apache/PHP进程对外连接。可临时关闭防火墙测试，或在防火墙规则中添加允许PHP进程访问9003端口的权限。

• 确认Apache加载的PHP版本：
  WAMP可能存在多PHP版本，通过phpinfo()页面查看Loaded Configuration File路径，确认Apache加载的是已配置Xdebug的php7.1.33版本对应的php.ini。

• 查看Xdebug日志定位问题：
  修复日志路径后重启Apache，访问hello.localhost，查看c:/wamp64/logs/xdebug.log内容，日志会显示Xdebug尝试连接的地址、端口及连接状态，可根据日志进一步排查连接失败原因。

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