Windows 10下Docker-compose构建失败，请求排查问题原因

可能原因及对应修复方案 #

1. 网络访问故障（最常见触发因素） #

退出码100在apt-get操作中大多是网络请求失败导致，比如官方镜像源无法访问、Docker网络配置异常。

• 修复：
  • 替换为国内镜像源：在apt-get update前修改系统源列表，示例Dockerfile片段：

    RUN sed -i 's/deb.debian.org/mirrors.tuna.tsinghua.edu.cn/g' /etc/apt/sources.list && \
        apt-get update && \
        apt-get install -y netcat gettext httpie && \
        pip install --upgrade pip && \
        pip install flask
    

  • 调整Docker网络设置：打开Docker Desktop的设置面板，切换到"网络"选项卡，尝试启用"使用系统代理"，或手动设置DNS为8.8.8.8/114.114.114.114。

2. apt源索引损坏或依赖冲突 #

源索引缓存损坏、包依赖冲突会导致安装进程异常退出。

• 修复：
  • 加入--fix-missing参数修复索引，同时用--no-install-recommends减少依赖：

    RUN apt-get update --fix-missing && \
        apt-get install -y --no-install-recommends netcat gettext httpie && \
        pip install --upgrade pip && \
        pip install flask
    

3. PyPI源访问问题 #

如果是pip升级或安装Flask时出错，也会导致整个RUN命令返回退出码100。

• 修复：
  • 给pip指定国内镜像源，加速访问：

    RUN apt-get update && \
        apt-get install -y netcat gettext httpie && \
        pip install --upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple && \
        pip install flask -i https://pypi.tuna.tsinghua.edu.cn/simple
    

4. Dockerfile命令格式错误 #

检查RUN命令的串联逻辑，确保所有步骤通过&&连接，避免单个步骤失败后后续步骤无意义执行（退出码100通常是前置步骤失败）。

• 修复：确保命令串联正确，示例：

  RUN apt-get update && \
      apt-get install -y netcat gettext httpie && \
      pip install --upgrade pip && \
      pip install flask
  

5. Windows Docker环境特殊问题 #

Windows下Docker的文件共享权限、后端兼容性可能影响构建：

• 修复：
  • 检查Docker Desktop的"共享驱动器"设置，确保项目所在盘符已授权共享。
  • 切换到WSL2后端运行Docker（若当前用Hyper-V），WSL2的网络兼容性更稳定。

排查建议 #

1. 分步测试命令：拆分Dockerfile中的RUN步骤，单独执行每一段命令，定位具体失败环节（比如先跑apt-get update，确认成功后再添加安装包命令）。
2. 查看完整构建日志：执行docker-compose up --build（去掉-d参数），查看日志中具体哪一行命令抛出错误，精准定位问题。

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