You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Windows10+WSL2 Docker环境下PhpStorm配置Xdebug3失败求助

问题:WSL2 Docker容器内Xdebug3无法在PhpStorm中正常使用

环境信息

  • Windows10主机,WSL2 Ubuntu引擎,通过micro-env程序部署Docker
    micro-env部署Docker截图
  • WSL2固定IP:

172.23.183.202

  • 目标:配置PHP7 Docker容器内的Xdebug3,使其能在PhpStorm中正常调试

容器网络信息

执行命令:

docker inspect groomrhv2-php -f "{{json .NetworkSettings.Networks }}" --format json | jq . 

输出:

"NetworkSettings": {
      "Bridge": "",
      "SandboxID": "7293963ad4db7c70a3c7e4c24fb7c4e04c26cf4c2c2723a55272aeba90b8fd37",
      "HairpinMode": false,
      "LinkLocalIPv6Address": "",
      "LinkLocalIPv6PrefixLen": 0,
      "Ports": {
        "443/tcp": [
          {
            "HostIp": "0.0.0.0",
            "HostPort": "443"
          },
          {
            "HostIp": "::",
            "HostPort": "443"
          }
        ],
        "80/tcp": [
          {
            "HostIp": "0.0.0.0",
            "HostPort": "8080"
          },
          {
            "HostIp": "::",
            "HostPort": "8080"
          }
        ],
        "9000/tcp": null
      },
      "SandboxKey": "/var/run/docker/netns/7293963ad4db",
      "SecondaryIPAddresses": null,
      "SecondaryIPv6Addresses": null,
      "EndpointID": "",
      "Gateway": "",
      "GlobalIPv6Address": "",
      "GlobalIPv6PrefixLen": 0,
      "IPAddress": "",
      "IPPrefixLen": 0,
      "IPv6Gateway": "",
      "MacAddress": "",
      "Networks": {
        "groomrhv2_dockerized_default": {
          "IPAMConfig": null,
          "Links": null,
          "Aliases": [
            "groomrhv2-php",
            "groomrhv2-php",
            "c1aa5080ef3e"
          ],
          "NetworkID": "3fb9d9c63780fe121610305d6d164d70508c1ebb3c7de9267ddbba3feff39b58",
          "EndpointID": "e717eecc4374e4f025bf83b98945d87bd8e973ebd7a53d11538fa10bb460f064",
          "Gateway": "172.22.0.1",
          "IPAddress": "172.22.0.5",
          "IPPrefixLen": 16,
          "IPv6Gateway": "",
          "GlobalIPv6Address": "",
          "GlobalIPv6PrefixLen": 0,
          "MacAddress": "02:42:ac:16:00:05",
          "DriverOpts": null
        }
      }
    }
  }

容器内PHP配置信息

进入容器命令:

docker exec -ti groomrhv2-php bash

执行php --ini输出:

Cannot load Xdebug - it was already loaded
Configuration File (php.ini) Path: /usr/local/etc/php
Loaded Configuration File:         (none)
Scan for additional .ini files in: /usr/local/etc/php/conf.d
Additional .ini files parsed:      /usr/local/etc/php/conf.d/docker-php-ext-config.ini,
/usr/local/etc/php/conf.d/docker-php-ext-gd.ini,
/usr/local/etc/php/conf.d/docker-php-ext-intl.ini,
/usr/local/etc/php/conf.d/docker-php-ext-opcache.ini,
/usr/local/etc/php/conf.d/docker-php-ext-pdo_pgsql.ini,
/usr/local/etc/php/conf.d/docker-php-ext-sodium.ini,
/usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini,
/usr/local/etc/php/conf.d/error_reporting.ini,
/usr/local/etc/php/conf.d/opcache.ini,
/usr/local/etc/php/conf.d/xdebug.ini
  • Xdebug扩展路径:/usr/local/lib/php/extensions/no-debug-non-zts-20190902/xdebug.so
  • php.ini路径:/usr/local/etc/php

PhpStorm已完成的配置

  1. 添加Docker配置
    PhpStorm添加Docker截图
  2. 添加PHP CLI解释器
    PhpStorm添加PHP CLI解释器截图

Xdebug配置(xdebug.ini)

[xdebug]
zend_extension=/usr/local/lib/php/extensions/no-debug-non-zts-20190902/xdebug.so
xdebug.mode=debug,develop,profile
xdebug.discover_client_host=false
xdebug.client_host=172.23.183.202
xdebug.client_port=9000
xdebug.start_with_request=yes
xdebug.idekey=GroomRHV2
XDEBUG_SESSION=GroomRHV2
xdebug.cli_color=1
xdebug.log_level=3
xdebug.remote_autostart = 1
xdebug.remote_enable = 1

调试配置验证结果

尝试验证Web服务器调试器配置:
PhpStorm验证Web服务器调试器配置截图
验证结果:
PhpStorm验证结果截图

目前无法在PhpStorm中使用Xdebug3,请求帮助解决。


内容的提问来源于stack exchange,提问作者Khaled Boussoffara

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.17 03:52:51