WSL 2中Docker暴露UDP端口后C++程序绑定端口失败问题排查

核心原因 #

你遇到的问题本质是WSL2网络特性与Docker端口映射的交互冲突，结合UDP端口绑定的规则，具体原因有两个：

1. Docker端口映射的隐性占用
   在WSL2模式下，Docker Desktop实际运行在Windows后台，端口映射（-p 9090:9090/udp）会由Windows侧的Docker服务完成绑定。它默认会同时绑定IPv6的:::9090和对应IPv4的0.0.0.0:9090（因为Linux默认net.ipv6.bindv6only=0，即绑定IPv6端口会自动占用IPv4同名端口）。但这个绑定属于Windows系统进程，在WSL2的netstat中无法识别到PID，所以你看到的是-。

2. 端口绑定的优先级冲突
   当你先启动Docker，它已经通过Windows侧占用了IPv4和IPv6的9090端口，你的C程序尝试绑定IPv4的0.0.0.0:9090（INADDR_ANY对应的IPv4地址）时，就会触发端口占用错误。而如果先启动C程序，它先绑定了IPv4的9090端口，Docker的端口映射可以通过iptables的DNAT规则绕过直接绑定，所以两者能共存。

解决方案 #

根据你的需求，推荐以下几种解决方式，按优先级从高到低排序：

方案1：取消端口映射，直接通过容器网络通信（最优）

WSL2与Docker容器处于同一虚拟网络环境中，完全不需要将容器端口映射到主机，直接通过容器IP或名称通信即可，彻底避免端口冲突：

• 修改docker-compose.yml，删除- "9090:9090/udp"这一行；
• 启动容器后，执行docker inspect my-php | grep IPAddress获取容器的IPv4地址（比如172.17.0.2）；
• 修改C++程序，将目标地址改为容器IP：

  addr_serv.sin_addr.s_addr = inet_addr("172.17.0.2"); // 替换为你的容器实际IP
  

  如果你想更灵活，可以在C++中加入DNS解析逻辑，直接使用容器名称my-php来获取IP（Docker默认的DNS服务会自动解析容器名称）。

方案2：让Docker仅绑定IPv4端口

修改docker-compose.yml的端口映射规则，明确指定绑定IPv4的0.0.0.0，避免Docker占用IPv6端口：

ports:
  - "9000:9000"
  - "0.0.0.0:9090:9090/udp"

这样Docker只会占用IPv4的9090端口，你可以调整C++程序绑定到WSL2的内部IP（而非INADDR_ANY），或者调整两者的端口号避免冲突。

方案3：开启IPv6绑定独占

在WSL2的发行版中修改sysctl参数，让IPv6端口绑定不会占用IPv4端口：

• 临时生效：执行sudo sysctl -w net.ipv6.bindv6only=1；
• 永久生效：编辑/etc/sysctl.conf，添加net.ipv6.bindv6only=1，然后执行sudo sysctl -p。
  这样Docker绑定的IPv6 9090端口不会影响IPv4的9090端口，你的C++程序可以正常绑定IPv4的0.0.0.0:9090。

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