Cloud Run部署Python FastAPI报No module named 'alpha'导入错误

报错本质是Python模块搜索路径和运行时工作目录不匹配：

• 本地运行时，你是在app目录下启动应用，Python会自动将当前工作目录（app/）加入模块检索路径，alpha作为app/下的子目录可以被直接识别，因此导入正常。
• 部署到Cloud Run时，容器默认工作目录是根目录/，你的启动命令是uvicorn app.main:app，此时Python的模块检索路径仅包含根目录，你写的from alpha import beta会去根目录下查找alpha文件夹，但实际alpha的路径是/app/alpha，自然会触发ModuleNotFoundError。
  你之前把beta.py的逻辑全部写入main.py时不需要跨模块导入，因此不会触发路径问题，可以正常部署。

任选以下一种方案修改即可：

• 方案1：修正导入路径（改动最小，无需调整Dockerfile）
  将main.py中的导入语句修改为全量模块路径：

  from app.alpha import beta
  

  修改后Python会从容器根目录开始检索，正确找到/app/alpha模块，适配现有启动逻辑。注意本地调试时不要在app目录下直接启动，回到项目根目录执行uvicorn app.main:app即可正常运行。

• 方案2：调整容器工作目录，和本地运行环境对齐
  修改Dockerfile，显式设置工作目录为/app，调整文件复制逻辑和启动命令，修改后的Dockerfile内容如下：

  FROM python:3.9
  
  # 设置容器工作目录为/app
  WORKDIR /app
  
  # 先复制依赖清单安装依赖，利用构建缓存
  COPY requirements.txt ./
  RUN python -m pip install --upgrade pip &&\
      pip install -r requirements.txt
  
  # 把本地app目录下的所有代码复制到容器工作目录
  COPY ./app ./
  
  # 工作目录已在/app，直接启动main模块即可
  CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8080"]
  

  修改后容器内的代码结构和你本地app目录下的结构完全一致，原有的from alpha import beta语句不需要改动，和本地运行逻辑完全对齐。

不推荐通过新增PYTHONPATH环境变量的方式修复，该方案会隐式修改Python检索规则，后续项目结构调整时容易出现隐性路径问题。

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