VSCode+Docker＋nginx環境でのPHPデバッグでxdebugが接続できない

Question

環境

【ホストPC】
・Windows10
・VSCode（拡張機能としてPHP Debug v1.26.0）
・Ubuntu20.04 on Windows

【Ubuntu内】
・Docker 20.10.12
・nginx
・PHP 8.0.17
・xdebug 3.1.4

実現したいこと

・コンテナ内のxdebugをホストPCに接続させたい。
・最終的にホストPCのVSCodeでPHPをデバッグしたい。

発生している問題・エラーメッセージ

コンテナ起動時にxdebugが立ち上がるとこまでは確認できたのですが、ブラウザから「localhost:xxxx」でPHPにアクセスしてからxdebug.logを見ると

[10] [Step Debug] INFO: Client host discovered through HTTP header, connecting to 180.30.0.1:9003.
[10] [Step Debug] WARN: Creating socket for '180.30.0.1:9003', poll success, but error: Operation now in progress (29).
[10] [Step Debug] WARN: Could not connect to client host discovered through HTTP headers, connecting to configured address/port: host.docker.internal:9003. :-|
[10] [Step Debug] WARN: Creating socket for 'host.docker.internal:9003', poll success, but error: Operation now in progress (29).
[10] [Step Debug] ERR: Could not connect to debugging client. Tried: 180.30.0.1:9003 (from REMOTE_ADDR HTTP header), host.docker.internal:9003 (fallback through xdebug.client_host/xdebug.client_port) :-(

上記ログのように接続がうまくいってません。

確認済み事項

【ホストPC】
VSCode上で「デバッグの開始」を押しコマンドプロンプトからnetstat -anコマンドで下記状態を確認。

  プロトコル  ローカル アドレス      外部アドレス           状態
  TCP         0.0.0.0:9003           0.0.0.0:0              LISTENING

【Ubuntu内】
・docker exec -it [app] bashでコンテナへログイン、php -vコマンドで下記状態を確認。

PHP 8.0.17 (cli) (built: Mar 29 2022 02:31:00) ( NTS )
Copyright (c) The PHP Group
Zend Engine v4.0.17, Copyright (c) Zend Technologies
    with Xdebug v3.1.4, Copyright (c) 2002-2022, by Derick Rethans

・cat /etc/hosts | awk 'END{print $1}' | sed -r -e 's/[0-9]+$/1/g'コマンドでホストPCのIPが180.30.0.1を確認。
・ホストPCに対してpingが通っていることは確認したがnc -vz 180.30.0.1 9003は「Connection refused」エラー。
・php -i | grep xdebugで設定値が読み込まれていることを確認。

各種設定ファイル

    "version": "0.2.0",
    "configurations": [
        {
            "name": "Listen for Xdebug",
            "type": "php",
            "request": "launch",
            //下記を追加
            "hostname": "0.0.0.0",
            "port": 9003,
            "pathMappings": {
                "/var/www/html/hogehoge":"${workspaceRoot}/hogehoge",
            },
        },

    hogehoge_php-fpm:
        restart: always
        container_name: hogehoge_php-fpm
        build: ./php-fpm
        volumes:
            - ./source:/var/www/html
            - ./php-fpm/phpconf:/usr/local/etc/php
        networks:
            hogehoge_network:
                ipv4_address: 180.30.0.3
        extra_hosts:
            - "host.docker.internal:host-gateway"

[xdebug]
xdebug.mode=debug
xdebug.client_host=host.docker.internal
xdebug.client_port=9003
xdebug.start_with_request=yes
xdebug.log=/tmp/xdebug.log
xdebug.discover_client_host = 1

補足情報（FW/ツールのバージョンなど）

不足情報あればなるべく追記いたします。
何卒よろしくお願いいたします。

Answer 1

こちら自己解決のため回答記載します。

原因はphp.iniに記載したxdebugの設定でした。
dockerconpose.yml内で

networks:
    hogehoge_network:
        name: hogehoge_network
        driver: bridge
        ipam:
            config:
                - subnet: 180.30.0.0/24
                  gateway: 180.30.0.1

上記の設定を記載していたのですが、これがあるとホストのIPがどうであれ通信は「180.30.0.1」として処理されるようです。
そのためxdebug.discover_client_hostがホストIPまでコネクトバックしてくれず、ゲートウェイまでの通信で止まっていました。「ゲートウェイIP＝ホストPCのIP」だと認識していたのがそもそも間違いでした…。

---

1.ホストPCのIPを再度確認
ubunntuを動かしている（VSCodeを動かしている）PCのコマンドプロンプトで「ipconfig」発行。
「イーサネット アダプター vEthernet (WSL)」で使用しているIPv4アドレスを確認。

2.php.iniの修正
xdebug.client_host=【1で確認したIP】に修正
xdebug.discover_client_host = 0に修正しコネクトバック機能をOFF

---

上記修正により無事VSCodeとの接続を確認できました。
こちらをもって本件はクローズとさせていただきます。