Docker镜像在WSL中构建失败，Windows环境构建正常的原因

错误码8是wget的典型网络类错误，通常对应服务器返回4xx/5xx状态码（比如403访问被拒、404资源不存在），或者本地网络无法建立有效连接。Windows和WSL环境下构建结果不同，核心是两者的网络配置、环境变量存在差异：

核心差异点 #

• 网络栈与DNS配置不同：Windows Docker Desktop默认复用Windows系统的网络栈和DNS设置，而WSL终端中运行的Docker（尤其是WSL2后端）使用的是WSL独立的虚拟网络，DNS解析规则、路由可能和Windows不一致，导致无法正确解析jar包的下载域名。
• 代理环境不一致：Windows系统如果配置了全局代理，Docker Desktop会自动继承该代理设置；但WSL终端的环境变量默认不会同步Windows的代理，导致wget无法通过代理访问目标资源，或者WSL本身配置了无效代理引发连接失败。
• WSL网络权限限制：WSL的虚拟网络可能受到Windows防火墙、杀毒软件的拦截，或者WSL2的网络适配器存在异常，导致请求无法发送到目标服务器。

解决步骤 #

1. 直接测试WSL内的网络连通性
   • 在WSL终端单独执行wget [你的jar包完整下载URL]，确认是否能正常下载。如果失败，先排查WSL本身的网络问题：
     • 执行nslookup [jar包域名]，检查域名是否能正常解析。如果解析失败，编辑/etc/resolv.conf，添加Windows系统的DNS服务器地址（可通过Windows的ipconfig命令查看WSL适配器的DNS）。
2. 同步代理配置
   • 如果Windows使用了代理，在WSL终端临时设置代理环境变量后再构建：

     export HTTP_PROXY=http://你的代理地址:端口
     export HTTPS_PROXY=http://你的代理地址:端口
     docker build .
     

     也可以在Dockerfile中添加代理配置（注意不要泄露敏感信息）：

     ENV HTTP_PROXY=http://你的代理地址:端口
     ENV HTTPS_PROXY=http://你的代理地址:端口
     RUN wget [jar包URL]
     

3. 重置WSL网络
   • 若WSL网络存在异常，在Windows PowerShell中执行wsl --shutdown关闭所有WSL实例，重新打开WSL终端后再尝试构建。
4. 替换下载工具
   • 部分场景下wget的兼容性不如curl，可修改Dockerfile中的下载命令：

     RUN curl -O [jar包完整下载URL]
     

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