VSCode Dev Container构建报错：Internet not reachable 求助

根据你提供的报错信息，核心问题是Dev Container内无法连接外网，导致SDKMAN无法下载安装Maven。以下是针对该问题的补充排查和解决方法：

1. 验证容器基础网络连通性 #

• 启动临时容器测试外网访问：

  docker run --rm alpine ping -c 3 google.com
  

  如果ping不通，说明Docker容器本身的网络存在问题，而非项目配置。

2. 调整Docker网络配置 #

• 修改Docker DNS设置：
  打开Docker Desktop设置 -> Docker Engine，添加/修改dns字段为公共DNS服务器：

  {
    "dns": ["8.8.8.8", "1.1.1.1"]
  }
  

  保存后重启Docker。
• WSL2环境网络检查：
  在WSL终端执行cat /etc/resolv.conf，确认DNS服务器地址是否有效。若异常，可手动修改该文件（或在Windows网络适配器中为WSL适配器设置固定DNS）。

3. 调整Dev Container网络模式 #

• 检查项目.devcontainer/devcontainer.json：
  若存在network自定义网络配置，尝试注释掉该字段，使用默认网络。
• 强制容器使用主机网络：
  在devcontainer.json中添加runArgs：

  "runArgs": ["--network", "host"]
  

  让容器直接共享主机网络栈，绕过容器网络隔离问题。

4. 绕过SDKMAN在线安装 #

• 用系统包管理器直接安装Maven：
  修改Dev Container的Dockerfile，替换SDKMAN安装命令为：

  # Ubuntu/Debian环境
  RUN apt-get update && apt-get install -y --no-install-recommends maven
  
  # Alpine环境
  RUN apk add --no-cache maven
  

• 离线安装SDKMAN包：
  提前下载对应版本的Maven压缩包到项目.devcontainer目录，在Dockerfile中手动指定本地文件安装：

  COPY maven-3.9.6-bin.tar.gz /tmp/
  RUN su vscode -c "umask 0002 && . /usr/local/sdkman/bin/sdkman-init.sh && sdk install maven 3.9.6 /tmp/maven-3.9.6-bin.tar.gz"
  

5. 排查代理与防火墙干扰 #

• 关闭主机端代理软件（如Clash、Proxy SwitchyOmega等）后重新构建。
• 检查Docker代理设置：
  打开Docker Desktop设置 -> Resources -> Proxies，选择"No proxy"，重启Docker。
• 清空WSL2内的代理环境变量：
  在WSL终端执行unset HTTP_PROXY HTTPS_PROXY，并检查~/.bashrc/~/.zshrc中是否有持久化的代理配置，如有则注释掉。

6. 替换SDKMAN镜像源 #

如果是地区网络限制导致无法访问官方源，可切换国内镜像：
在Dockerfile中SDKMAN初始化后添加：

RUN su vscode -c ". /usr/local/sdkman/bin/sdkman-init.sh && echo 'sdkman_baseurl=https://mirrors.tuna.tsinghua.edu.cn/sdkman' >> ~/.sdkman/etc/config"

再执行sdk install maven命令。

7. 检查WSL2与主机网络连通性 #

• 在WSL终端ping主机内网IP（如ping 192.168.1.100），确认网络连通。
• 临时关闭Windows Defender防火墙，测试是否是防火墙阻断了WSL与外网的连接。

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