Shopware Docker环境下Xdebug配置失败问题排查求助

问题背景 #

尝试为shopware-docker配置Xdebug但未成功，根据官方文档提示，需设置环境变量VHOST_[FOLDER_NAME_UPPER_CASE]_IMAGE=ghcr.io/shyim/shopware-docker/6/nginx:php74-xdebug，替换文件夹名后执行swdc up即可激活Xdebug，但过程中遇到多阶段问题。

阶段1：镜像拉取失败 #

核心疑问：环境变量中的文件夹名称应填写哪个？ #

使用本地项目路径/var/www/html/myname中的myname，设置VHOST_MYNAME_IMAGE=ghcr.io/shyim/shopware-docker/6/nginx:php74-xdebug后，执行swdc up myname报错：

swdc up myname
[+] Running 2/0
 ⠿ Network shopware-docker_default    Created                                                                                                                                  0.0s
 ⠿ Container shopware-docker-mysql-1  Created                                                                                                                                  0.0s
[+] Running 1/1
 ⠿ Container shopware-docker-mysql-1  Started                                                                                                                                  0.3s
.database ready!
[+] Running 0/1
 ⠿ app_myname Error                                                                                                                                                       1.7s
Error response from daemon: manifest unknown

临时解决：更换镜像标签 #

改用PHP8.1版本的Xdebug镜像标签后，应用成功启动：

// $HOME/.config/swdc/env
...
VHOST_MYNAME_IMAGE=ghcr.io/shyim/shopware-docker/6/nginx:php81-xdebug

阶段2：断点无响应 #

应用启动后，在index.php中设置断点，调试工具无任何反应。

阶段3：路径映射失效 #

添加xdebug_break()代码后可触发调试，但调试日志出现路径映射警告：

...
Cannot find a local copy of the file on server /var/www/html/%my_path%
Local path is //var/www/html/%my_path%
...

尝试点击调试工具中的「Click to set up path mapping」时，「File path in project」输入框显示undefined。已按照手册在File | Settings | PHP | Servers中配置路径映射，但仍不生效，问题出在哪里？

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