Docker部署Python-Flask应用报错：flask可执行文件不在$PATH中

报错内容 #

docker: Error response from daemon: failed to create task for container: failed to create shim task: OCI runtime create failed: runc create failed: unable to start container process: exec: "flask": executable file not found in $PATH: unknown.

我的Dockerfile #

FROM python:3.9-buster

WORKDIR /app

COPY requirements.txt .

RUN pip install --no-cache-dir -r requirements.txt

COPY . .

ENV FLASK_RUN_HOST=0.0.0.0

EXPOSE 5000

CMD ["flask", "run"]

执行命令 #

docker build -t my-flask-app .
docker run -p 5000:5000 (我的镜像ID)

问题原因 #

直接调用flask命令时，容器的$PATH中找不到该可执行文件。通常是因为pip安装的flask二进制文件路径未被正确加入系统环境变量，或者依赖安装存在疏漏。

修复方案 #

方案1：改用Python模块方式启动（推荐） #

修改Dockerfile中的CMD指令，通过Python模块调用Flask，无需依赖$PATH配置：

CMD ["python", "-m", "flask", "run"]

这种方式绕过了直接调用可执行文件的问题，兼容性更强，也是Flask官方推荐的启动方式之一。

方案2：确认Flask依赖及PATH配置 #

1. 确保requirements.txt中包含Flask依赖（例如Flask==2.3.3），否则pip不会安装flask命令。
2. 可在Dockerfile中添加检查步骤，验证flask命令的路径：

RUN pip install --no-cache-dir -r requirements.txt && which flask

如果输出为/usr/local/bin/flask，说明该路径默认在容器的$PATH中，若仍报错，可显式指定完整路径启动：

CMD ["/usr/local/bin/flask", "run"]

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