Windows Server 2019构建Linux容器镜像执行RUN命令失败如何解决

• 平台不匹配：你使用的基础镜像是Linux架构的python:3.8-slim-buster，Windows Server 2019上的Docker默认如果没有明确指定平台参数，构建时会优先匹配宿主Windows平台，导致Linux镜像的容器进程无法正常启动，触发hcsshim组件的系统调用错误
• Docker运行模式异常：你手动run镜像正常说明你的Docker已经开启了Linux容器支持，但构建命令未强制指定使用Linux容器运行时，调用了Windows容器运行时执行Linux镜像指令，导致容器启动后直接崩溃退出
• 补充：你Dockerfile中虚拟环境激活的写法存在逻辑问题，不过这不是本次报错的直接原因，后续也需要修正避免运行异常

1. 构建时强制指定Linux平台 #

执行docker build时添加平台参数：
docker build --platform linux/amd64 .
如果用docker-compose，在service的build配置下添加platform字段：

services:
  server:
    build:
      context: .
      dockerfile: Dockerfile
      platform: linux/amd64

2. 确认Docker运行模式切换为Linux容器 #

执行命令确认当前Docker默认运行的容器架构：
docker info | findstr "OSType"
如果输出是OSType: windows，执行切换命令：
& $Env:ProgramFiles\Docker\Docker\DockerCli.exe -SwitchLinuxEngine

3. 修正Dockerfile中虚拟环境的错误写法 #

每一条RUN指令都是独立的shell会话，单次激活虚拟环境不会对后续RUN生效，需要把虚拟环境的bin目录加入PATH环境变量，或者把相关命令合并到同一条RUN：

# 替换原来的多条虚拟环境相关RUN指令
RUN python3 -m venv /opt/venv
ENV PATH="/opt/venv/bin:$PATH"
RUN pip install --no-cache-dir --upgrade pip \
    && pip install --no-cache-dir --upgrade setuptools \
    && pip install --no-cache-dir -r requirements/common.txt \
    && pip install --no-cache-dir psycopg2-binary

4. 可选验证方案 #

如果上述方法还是报错，可以先在WSL2发行版内部安装Docker，直接在Linux环境下执行构建，避免Windows宿主的兼容问题。

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