如何解决Docker环境下PhpStorm反复弹出Xdebug入站连接提示的问题

1. 修复xdebug.ini配置错误 #

你的配置存在2个核心冲突/错误：

• 同时开启了xdebug.remote_connect_back=1和配置了xdebug.remote_host=host.docker.internal，两个参数互斥：开启remote_connect_back后Xdebug会自动使用请求来源IP建立连接，直接忽略手动配置的remote_host值。Docker场景下建议关闭remote_connect_back，使用固定的remote_host值，修改为xdebug.remote_connect_back=0。
• 配置存在无效值xdebug.max_nesting_level=1500T，末尾的T属于笔误，同时存在重复配置的xdebug.max_nesting_level = 1000、xdebug.remote_handler=dbgp项，需要删除重复项修正无效值。

修正后的参考配置如下：

xdebug.default_enable=1
xdebug.remote_enable=1
xdebug.remote_autostart=1
xdebug.remote_connect_back=0
xdebug.remote_host=host.docker.internal
xdebug.remote_port=9000
xdebug.idekey=PHPSTORM
xdebug.remote_handler = dbgp
xdebug.remote_mode = req
xdebug.max_nesting_level = 1500
xdebug.var_display_max_children = 512
xdebug.var_display_max_data = 512
xdebug.var_display_max_depth = 12
xdebug.profiler_enable = off
xdebug.profiler_enable_trigger = off
xdebug.profiler_output_name = cachegrind.out.%t.%p
xdebug.profiler_output_dir = "/tmp/php7-xdebug.log"
xdebug.remote_log="/tmp/xdebug.log"

修改完成后重启容器内的PHP服务生效。

2. 校验路径映射配置 #

弹出连接提示的核心原因是PhpStorm无法将Xdebug传回的容器内文件路径匹配到本地项目文件：

• 从Xdebug日志可知容器内项目根路径为/var/www/html/domestico2.local/，需要在PhpStorm对应服务配置中，将本地项目根目录精确映射到上述容器内路径，注意大小写、路径前后的斜杠要完全匹配。
• 确认PhpStorm的Xdebug监听端口为9000，且没有被php-fpm等其他服务占用，如有冲突可以将Xdebug端口统一修改为9003避免抢占。

3. 关闭无关请求的调试提示 #

如果favicon.ico、静态资源等不需要调试的请求也触发提示，可以打开PhpStorm的Settings > PHP > Debug，在Xdebug配置区取消勾选Force break at first line when no path mapping specified和Force break at first line when a script is outside the project选项即可。

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