Azure容器实例未执行Dockerfile全部RUN步骤的问题排查

核心原因 #

1. 构建上下文不一致导致RUN命令执行异常 #

本地构建镜像时，你的本地目录里已经存在/import/project/import路径，或通过其他步骤提前把项目文件放到了这个目录下，所以RUN里的cd命令能正常切换目录，后续的git checkout、poetry install都能按预期执行，依赖安装正常。但在Azure环境构建时，构建上下文里根本没有这个目录，cd命令直接失败。而Docker默认的shell不会因为单个命令失败就终止整个RUN步骤，后面的poetry install会在根目录执行——找不到pyproject.toml或requirements.txt，等于没装任何依赖，但构建过程不会报错，最终镜像里缺少click模块，运行时就出现了ModuleNotFoundError。

2. 镜像缓存复用跳过了依赖安装 #

Azure构建时很可能复用了之前的镜像缓存层。如果你的Dockerfile里，RUN步骤前面的镜像层（比如COPY的文件没有变化）没更新，Azure就会直接跳过这个RUN步骤，使用旧的镜像层——旧层里根本没安装所需依赖。本地构建时你可能清理过缓存（比如加了--no-cache参数）或修改了前置文件，所以RUN步骤会重新执行，依赖安装正常。

3. Poetry虚拟环境未被正确激活 #

RUN步骤里用poetry install装的依赖，默认会放在Poetry创建的虚拟环境里。但你的CMD命令直接运行/import/start-scheduler，没有激活这个虚拟环境。本地运行时你可能通过shell自动激活了虚拟环境，所以能找到依赖；但Azure ACI中容器直接执行CMD命令，没有激活虚拟环境的过程，自然找不到虚拟环境里的click模块。而把poetry install移到CMD里执行时，poetry run会自动激活虚拟环境来执行后续命令，依赖就能被正确找到。

解决方案 #

• 先确保目录存在再执行命令：在Dockerfile里提前创建目标目录，或先把项目文件COPY进去，再执行RUN命令：

  RUN mkdir -p /import/project/import
  COPY ./your-project-files /import/project/import/
  RUN cd /import/project/import && git checkout docker-image && poetry install --no-root && poetry run pip install -r requirements.txt
  

• 禁用构建缓存：Azure构建镜像时添加--no-cache参数，强制重新执行所有RUN步骤，避免复用旧缓存层。
• 用WORKDIR设置默认工作目录：不要在RUN里用cd切换目录，直接用WORKDIR指定工作目录，后续所有命令都会在该目录下执行：

  WORKDIR /import/project/import
  RUN git checkout docker-image && poetry install --no-root && poetry run pip install -r requirements.txt
  

• 让CMD通过poetry run启动程序：如果依赖安装在虚拟环境中，直接用poetry run启动程序，自动激活虚拟环境：

  CMD ["poetry", "run", "/import/start-scheduler"]
  

内容的提问来源于stack exchange，提问作者Chris B.