Ubuntu系统下Laravel 8 Sail+PhpStorm配置Xdebug调试失败求助

1. 补全Xdebug端口与IDE密钥配置 #

你当前的SAIL_XDEBUG_CONFIG缺少必要的端口和密钥参数，在.env中修改该配置为：

SAIL_XDEBUG_CONFIG="client_host=172.19.2.1 client_port=9003 idekey=PHPSTORM"

修改后执行sail down && sail up -d重启容器生效。

2. 放行宿主机9003端口 #

Ubuntu默认ufw防火墙会拦截容器向宿主机9003端口发起的连接请求，这是你页面加载慢、无调试触发的最常见原因，执行命令放行端口：

sudo ufw allow in on docker0 from 172.17.0.0/16 to any port 9003

如果你的Docker网段不是默认的172.17.0.0/16，可以替换为你步骤3获取的网关所属的网段即可。

3. 确认PhpStorm调试端口配置 #

打开PhpStorm设置，进入PHP > 调试页面，确认Xdebug区域的「调试端口」填写为9003，勾选「可以接受外部连接」选项。

4. 手动配置路径映射 #

零配置弹窗不触发的情况下可手动配置：

• 进入PhpStorm设置的PHP > 服务器页面，新增一个服务器配置
• 主机填写localhost，端口填你Sail映射的web端口（默认80），调试器选择Xdebug
• 勾选「使用路径映射」，在列表中将本地项目根目录的路径，映射到容器内的/var/www/html路径，保存配置即可。

配置完成后重启PhpStorm的调试监听，重新触发请求即可正常命中断点。

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