VS Code中XDebug调试失效求助：断点无响应配置排查

针对你的PHP 5.6 + Docker + VS Code调试环境，断点无响应主要是配置缺失和不一致导致的，以下是具体修复步骤：

1. 修正Xdebug配置（local.ini） #

你的配置缺少IDE主机地址，同时需要统一IDE Key，修改后的配置如下：

[xdebug]
zend_extension="xdebug.so"
xdebug.remote_enable=on
xdebug.remote_handler=dbgp
xdebug.remote_mode=req
xdebug.remote_port=9003
# 指定VS Code所在机器的IP
xdebug.remote_host=192.168.1.220
# 统一IDE Key为VSCODE，和VS Code配置匹配
xdebug.idekey="VSCODE"
# 使用绝对路径存储日志，避免权限问题
xdebug.remote_log="/var/log/xdebug.log"
xdebug.show_exception_trace=1

注意：需要在Docker容器内创建日志文件并赋予写入权限，执行命令：docker exec -it php_web touch /var/log/xdebug.log && chmod 666 /var/log/xdebug.log

2. 调整VS Code启动配置 #

确保IDE Key和路径映射准确，修正后的配置：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Listen for Xdebug",
            "type": "php",
            "request": "launch",
            "port": 9003,
            "pathMappings": {
                // 确认本地代码路径与容器内路径匹配，若${workspaceFolder}未指向./php/intra，替换为本地绝对路径
                "/var/www/html/": "${workspaceFolder}/php/intra"
            },
            "log": true,
            // 指定IDE Key与Xdebug配置一致
            "ideKey": "VSCODE"           
        },
        {
            "name": "Launch currently open script",
            "type": "php",
            "request": "launch",
            "program": "${file}",
            "cwd": "${fileDirname}",
            "port": 9003,
            "ideKey": "VSCODE"
        }
    ]
}

路径映射是核心：必须保证本地代码路径和容器内/var/www/html/的路径一一对应，否则VS Code无法匹配断点位置。

3. 验证网络与配置生效 #

• 检查VS Code所在机器（192.168.1.220）的9003端口是否开放，防火墙是否允许Docker容器访问该端口。
• 重启Docker容器：docker-compose restart web，确保新配置生效。
• 访问phpinfo页面，搜索xdebug，确认xdebug.remote_host、xdebug.remote_port、xdebug.idekey已正确加载。

4. 调试验证 #

1. 在VS Code中启动"Listen for Xdebug"调试会话。
2. 在本地代码中设置断点，访问网站对应页面。
3. 查看容器内的Xdebug日志/var/log/xdebug.log，若有连接成功日志则配置生效；若有连接失败信息，可根据日志排查网络问题。

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