GCP Cloud Run容器运行异常：本地与云端模块导入行为不一致

核心原因拆解 #

1. 导入行为差异的本质 #

你的Dockerfile设置了PYTHONPATH=/code/app，同时将工作目录设为/code/app：

• Cloud Run环境：/code/app被加入Python模块搜索路径，此时main.py所在目录作为PYTHONPATH的根，相对导入from .make_sticker.config import StickerConfig直接生效，因此代码不会进入except块。
• 本地容器环境：大概率是运行时没有正确传递PYTHONPATH变量，或者工作目录未设置为/code/app，导致相对导入的基准路径错误，触发except块执行。

2. Cloud Run无日志输出的关键原因 #

Docker中Python的print输出默认启用缓冲机制，Cloud Run的日志采集依赖容器的stdout/stderr输出，若未禁用缓冲，print内容会被暂存，无法实时被采集到，导致你看不到任何日志。

解决办法 #

统一导入逻辑（移除try/except） #

既然PYTHONPATH=/code/app已经将/code/app设为模块根目录，直接使用绝对导入即可兼容两种环境：

from make_sticker.config import StickerConfig

无需依赖try/except做兼容，避免环境差异导致的逻辑混乱。

禁用Python输出缓冲 #

在Dockerfile中添加环境变量PYTHONUNBUFFERED=1，强制print内容实时输出：

FROM python:3.12

WORKDIR /code

COPY app/requirements.txt /code/requirements.txt
RUN pip install --no-cache-dir -r requirements.txt

COPY app/ /code/app

ENV PYTHONPATH=/code/app
# 新增：禁用Python输出缓冲
ENV PYTHONUNBUFFERED=1

WORKDIR /code/app

RUN ls -la

EXPOSE 5001
CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "5001"]

对齐本地与Cloud Run的运行环境 #

本地运行容器时，严格复刻Cloud Run的环境参数，方便调试：

docker run -e PYTHONPATH=/code/app -w /code/app <你的镜像名称>

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