Docker部署Flask应用时出现prometheus_client模块导入错误

核心原因 #

本地通过pip安装的Python模块仅存在于宿主机环境，Docker容器是完全隔离的独立运行环境，不会共享宿主机的Python依赖包，因此容器启动时无法找到prometheus_client模块。

解决方案 #

1. 生成项目依赖清单 #

在Flask项目根目录创建requirements.txt文件，写入所有需要的依赖：

flask
prometheus-client

若项目还有其他Python依赖，一并添加到文件中

2. 修改Dockerfile确保安装依赖 #

检查你的Dockerfile，必须包含安装依赖的步骤，示例配置如下：

# 指定基础Python镜像
FROM python:3.9-slim

# 设置容器内工作目录
WORKDIR /app

# 复制依赖清单到容器并安装
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# 复制本地项目代码到容器
COPY . .

# 启动Flask应用的命令
CMD ["python", "app.py"]

如果原有Dockerfile缺少安装依赖的步骤，补充COPY requirements.txt和RUN pip install这两行

3. 重新构建并启动容器 #

执行以下命令刷新容器环境：

sudo docker-compose down
sudo docker-compose build --no-cache
sudo docker-compose up

额外排查点 #

• 确认docker-compose.yml中是否采用镜像构建方式（而非直接挂载宿主机目录却未在容器内安装依赖）
• 若使用本地虚拟环境，确保requirements.txt是从虚拟环境导出的：pip freeze > requirements.txt

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