PHP Xdebug报错：Socket not writable 求助（XAMPP+VSCode环境）

问题场景 #

在XAMPP环境下使用VSCode进行PHP Xdebug调试，今日Xdebug突然无法正常工作，报错提示continueRequest thread ID 1 error: socket not writable。其他PHP项目可正常调试，但当前项目出现该问题，已尝试更换端口，未解决。

相关配置 #

php.ini中的Xdebug配置：

[XDebug]
zend_extension = "C:\xampp\php\ext\php_xdebug-3.1.5-7.2-vc15-x86_64.dll"
xdebug.remote_autostart=1
xdebug.remote_enable=1
xdebug.start_with_request=yes
xdebug.remote_port=9001
xdebug.remote_connect_back=0
xdebug.mode=debug
xdebug.remote_log="C:\xampp\php\tmp\xdebug.log"

完整报错信息 #

Error: socket not writable
    at c:\Users\andre\.vscode\extensions\xdebug.php-debug-1.31.1\out\dbgp.js:140:24
    at new Promise (<anonymous>)
    at Connection.write (c:\Users\andre\.vscode\extensions\xdebug.php-debug-1.31.1\out\dbgp.js:132:16)
    at Connection._executeCommand (c:\Users\andre\.vscode\extensions\xdebug.php-debug-1.31.1\out\xdebugConnection.js:683:20)
    at Connection.<anonymous> (c:\Users\andre\.vscode\extensions\xdebug.php-debug-1.31.1\out\xdebugConnection.js:625:26)
    at Connection.emit (node:events:526:28)
    at Connection._handleDataChunk (c:\Users\andre\.vscode\extensions\xdebug.php-debug-1.31.1\out\dbgp.js:111:22)
    at Connection._handleDataChunk (c:\Users\andre\.vscode\extensions\xdebug.php-debug-1.31.1\out\dbgp.js:76:26)
    at Socket.<anonymous> (c:\Users\andre\.vscode\extensions\xdebug.php-debug-1.31.1\out\dbgp.js:47:42)
    at Socket.emit (node:events:526:28)

解决方法 #

• 检查当前项目的.vscode/launch.json配置：确认port值与php.ini中xdebug.remote_port完全一致；同时验证pathMappings的路径映射是否正确，路径使用正斜杠（/）或双反斜杠（\\），避免因路径解析错误导致连接异常。
• 清理并查看Xdebug日志：删除C:\xampp\php\tmp\xdebug.log文件后重新启动调试，通过新生成的日志排查连接失败的具体原因。
• 检查项目自定义配置：确认当前项目是否存在.user.ini或其他局部PHP配置文件，是否覆盖了全局php.ini中的Xdebug相关设置。
• 重启服务与编辑器：彻底关闭VSCode和XAMPP Apache服务后重新启动，确保配置变更生效，同时关闭可能占用目标端口的其他进程。
• 调整扩展版本：尝试降级或升级VSCode的PHP Debug扩展（当前版本为1.31.1），该版本可能存在兼容性问题。

内容的提问来源于stack exchange，提问作者André Giuly