Mac OS 10.13下Docker Toolbox搭配Xdebug调试PHP7.1问题求助

你的核心问题出在xdebug.remote_connect_back=1这个配置上，结合Docker Toolbox的网络环境，这会导致Xdebug无法正确连接到你的IDE，从而卡住页面加载。下面给你一步步的解决方案：

问题根源解释 #

Docker Toolbox会创建一个独立的VirtualBox虚拟机，你的PHP容器运行在这个虚拟机内部。当你开启remote_connect_back=1时，Xdebug会尝试连接当前请求的来源IP——也就是虚拟机的网关IP，而不是你的Mac主机IP。但你的IDE是运行在Mac主机上的，虚拟机这个IP并没有监听9000端口，所以Xdebug会一直等待连接，导致页面无限加载；关闭监听后，Xdebug放弃尝试，页面就正常加载了。

具体修复步骤 #

1. 修改Dockerfile中的Xdebug配置 #

把原来的xdebug.remote_connect_back=1替换为指定Mac主机在虚拟机网络中的IP，同时确保关闭自动回连：

RUN echo "xdebug.remote_enable=on" >> /usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini
RUN echo "xdebug.remote_autostart=true" >> /usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini
RUN echo "xdebug.remote_handler=dbgp" >> /usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini
RUN echo "xdebug.remote_mode=req" >> /usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini
RUN echo "xdebug.remote_port=9000" >> /usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini
RUN echo "xdebug.remote_log=/var/log/xdebug_remote.log" >> /usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini
RUN echo "xdebug.idekey=PHP_STORM" >> /usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini
# 关闭自动回连，指定Mac主机在虚拟机网络中的IP
RUN echo "xdebug.remote_connect_back=0" >> /usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini
RUN echo "xdebug.remote_host=192.168.99.1" >> /usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini

2. 确认你的Mac主机在虚拟机中的IP #

默认情况下，Docker Toolbox的虚拟机（通常叫default）对应的Mac主机IP是192.168.99.1，但如果你的虚拟机配置有改动，可以在终端运行以下命令确认：

docker-machine ip default

把命令返回的IP替换到上面的xdebug.remote_host中。

3. 检查Mac主机防火墙设置 #

确保Mac的防火墙允许9000端口的入站连接，否则Xdebug无法从虚拟机连接到你的IDE。你可以在「系统偏好设置」→「安全性与隐私」→「防火墙」→「防火墙选项」中添加规则，允许IDE（比如PhpStorm）接收连接，或者临时关闭防火墙测试。

4. 重建并重启容器 #

修改完Dockerfile后，重新构建镜像并启动容器：

# 如果用docker-compose管理容器
docker-compose build
docker-compose up -d

# 或者直接用docker命令
docker build -t your-php-image .
docker run -d -p 8088:80 your-php-image

5. 测试调试 #

开启IDE的「Start listening for Debug Connections」，刷新项目页面，现在应该能正常触发断点，页面也不会无限加载了。如果还是有问题，可以查看容器内的Xdebug日志/var/log/xdebug_remote.log，里面会记录连接尝试的细节，帮助进一步排查问题。

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