WSL2环境下Docker容器无法访问本地localhost的解决方案求助

核心问题 #

在WSL2环境中，host.docker.internal默认指向WSL2虚拟机自身IP，而非Windows主机IP，这是导致连接被拒绝的关键原因。同时需确保本地应用端口在Windows和WSL2环境中都能被正常访问。

分步解决步骤 #

1. 确保Spring Boot端口可跨环境访问 #

• 保持server.address=0.0.0.0的配置，让应用监听所有网卡。
• 打开Windows防火墙，添加入站规则，放行Spring Boot使用的端口（例如8080），允许私有网络访问。

2. 动态配置host.docker.internal指向Windows主机IP #

WSL2中可以通过/etc/resolv.conf获取Windows主机的IP（该文件中的nameserver地址就是Windows主机IP），以下是两种通用配置方式：

方式一：Docker Compose动态绑定（团队推荐）

在docker-compose.yml中添加动态主机映射：

services:
  your-docker-service:
    # 其他容器配置
    extra_hosts:
      - "host.docker.internal:${WSL_HOST_IP}"

启动容器前，在WSL2终端执行命令设置环境变量：

export WSL_HOST_IP=$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}')
docker-compose up -d

方式二：Docker Run命令直接绑定

docker run --add-host=host.docker.internal:$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}') your-image-name

3. 持久化配置（可选，适合固定IP场景） #

如果需要长期固定映射，可修改WSL2配置避免hosts文件被自动重置：

1. 在WSL2中创建或编辑/etc/wsl.conf：

[network]
generateHosts = false

2. 编辑/etc/hosts文件，添加Windows主机IP映射：

<你的Windows主机IP> host.docker.internal

注意：Windows主机IP若动态变化，此方法不适用，优先推荐方式一。

4. 验证连通性 #

进入容器内部，执行命令测试：

curl http://host.docker.internal:8080

若返回Spring Boot应用的响应，说明配置生效。

额外排查项 #

• 确认Docker Desktop已启用WSL2后端：进入Docker设置 -> Resources -> WSL Integration，确保对应的Ubuntu发行版处于启用状态。
• 检查容器网络模式：默认bridge网络即可正常访问主机IP，若使用自定义网络，需确保网络规则未限制对外访问。

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