Dockerfile本地运行正常，部署至Google Cloud Run后提示模块缺失？

本地构建运行以下Docker镜像时一切正常，但通过Prefect推送至Google Cloud Run后，运行时抛出ModuleNotFoundError: No module named 'pandas'错误。

关联代码 #

Dockerfile #

FROM --platform=linux/amd64 prefecthq/prefect:2-python3.12

RUN apt-get update && apt-get -y install libpq-dev gcc
RUN pip install --upgrade pip
RUN pip install pipenv

ENV PREFECT_API_URL="foo"
ENV PREFECT_API_KEY="bar"

WORKDIR /app

COPY Pipfile Pipfile
COPY Pipfile.lock Pipfile.lock

RUN pipenv install --deploy --ignore-pipfile

COPY . .

CMD ["pipenv", "run", "python", "src/cdk_flow/cdk_delta_flow.py"]

运行错误日志 #

Traceback (most recent call last):
  File "<frozen importlib._bootstrap_external>", line 995, in exec_module
  File "<frozen importlib._bootstrap>", line 488, in _call_with_frames_removed
  File "/app/src/cdk_flow/cdk_delta_flow.py", line 7, in <module>
    from src.cdk_flow.cdk_common_tasks import (
  File "/app/src/cdk_flow/cdk_common_tasks.py", line 3, in <module>
    import pandas as pd
ModuleNotFoundError: No module named 'pandas'

原因分析 #

• Pipenv虚拟环境路径不兼容：Pipenv默认会在构建用户的主目录下创建虚拟环境，而Cloud Run运行时的用户上下文可能与构建阶段不同，导致运行时无法定位到虚拟环境内的依赖包。本地构建和运行使用同一用户，所以路径匹配正常，但Cloud Run环境下路径失效。
• 虚拟环境引用上下文变化：pipenv run命令依赖构建时的环境变量来定位虚拟环境，当镜像被推送至Cloud Run后，运行环境的上下文（如用户、环境变量）发生变化，导致无法正确激活虚拟环境。
• 镜像缓存不一致：若Cloud Run拉取的是旧版本缓存镜像，可能未包含最新的依赖安装结果，但本地测试用的是新构建镜像，因此出现差异。

解决方案 #

方案1：强制Pipenv在项目目录内创建虚拟环境 #

添加PIPENV_VENV_IN_PROJECT=1环境变量，让虚拟环境直接生成在项目目录的.venv文件夹下，确保运行时能通过相对路径找到依赖：

FROM --platform=linux/amd64 prefecthq/prefect:2-python3.12

RUN apt-get update && apt-get -y install libpq-dev gcc
RUN pip install --upgrade pip
RUN pip install pipenv

# 让虚拟环境存放在项目目录内，避免路径问题
ENV PIPENV_VENV_IN_PROJECT=1
ENV PREFECT_API_URL="foo"
ENV PREFECT_API_KEY="bar"

WORKDIR /app

COPY Pipfile Pipfile
COPY Pipfile.lock Pipfile.lock

RUN pipenv install --deploy --ignore-pipfile

COPY . .

CMD ["pipenv", "run", "python", "src/cdk_flow/cdk_delta_flow.py"]

方案2：放弃Pipenv，直接用pip安装依赖 #

如果不需要Pipenv的虚拟环境管理，可以从Pipfile.lock导出依赖列表，用pip直接安装，彻底避免虚拟环境的路径问题：

FROM --platform=linux/amd64 prefecthq/prefect:2-python3.12

RUN apt-get update && apt-get -y install libpq-dev gcc
RUN pip install --upgrade pip

ENV PREFECT_API_URL="foo"
ENV PREFECT_API_KEY="bar"

WORKDIR /app

COPY Pipfile.lock Pipfile.lock
# 从Pipfile.lock导出requirements并安装
RUN pip install -r <(pipenv requirements)

COPY . .

CMD ["python", "src/cdk_flow/cdk_delta_flow.py"]

方案3：确保镜像一致性 #

推送镜像时指定明确的版本标签（如your-image:v1），避免Cloud Run拉取旧的缓存镜像。构建推送命令示例：

docker build -t gcr.io/your-project/your-image:v1 .
docker push gcr.io/your-project/your-image:v1

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