docker-compose环境下VSCode配置Xdebug调试无响应问题求助

问题根源 #

你使用的PHP8.0对应安装的是Xdebug 3版本，但配置中全部使用的是Xdebug 2的废弃参数，这是无响应的核心原因，同时存在部分配置拼写、跨系统兼容问题。

具体错误点： #

• 所有xdebug.remote_*前缀参数为Xdebug 2专属，Xdebug 3已全部重构为新的参数名
• 配置文件名拼写错误：dokcer-php-ext-xdebug.ini应为docker-php-ext-xdebug.ini
• Linux系统下Docker默认不解析host.docker.internal，需额外配置
• 双引号嵌套转义错误，echo语句内部使用双引号未转义会导致配置写入失败

修复后的配置 #

1. Dockerfile 修改 #

FROM php:8.0-apache
RUN docker-php-ext-install mysqli && docker-php-ext-enable mysqli
RUN pecl install xdebug && docker-php-ext-enable xdebug \
&& echo "\n\
xdebug.mode = debug \n\
xdebug.client_host = host.docker.internal \n\
xdebug.start_with_request = yes \n\
xdebug.discover_client_host = 0 \n\
xdebug.client_port = 9003 \n\
xdebug.log = /var/www/html/xdebug.log \n\
" >> /usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini
RUN apt-get update && apt-get upgrade -y

2. docker-compose.yml 补充兼容配置（Linux系统必加，Windows/Mac可跳过） #

在php-apache-environment配置块下新增extra_hosts配置：

php-apache-environment:
    container_name: php-apache
    build:
        context: ./
        dockerfile: Dockerfile
    depends_on:
        - db
    volumes:
        - ./:/var/www/html/
    ports:
        - 8000:80
    # 新增下面这行，Linux下实现host.docker.internal解析
    extra_hosts:
      - "host.docker.internal:host-gateway"

3. launch.json 无需修改，现有配置正确 #

你可以通过开启的log参数，在VSCode调试控制台查看Xdebug连接日志定位剩余问题，也可以查看容器内的/var/www/html/xdebug.log文件查看Xdebug运行日志。

生效操作 #

修改完成后执行以下命令重建容器：

docker-compose down && docker-compose up -d --build

然后重启VSCode调试，打了断点后刷新浏览器即可触发调试。

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