Cloud Run部署失败：容器未监听PORT=8001端口求助

问题核心 #

容器未监听Cloud Run指定的PORT环境变量端口，Cloud Run会动态分配端口并通过该变量传递，硬编码端口或启动逻辑冲突是主要诱因。

解决方法 #

方法1：复用镜像内置启动逻辑 #

tiangolo/uvicorn-gunicorn-fastapi镜像自带适配FastAPI的启动脚本，会自动读取PORT变量并监听端口，自定义CMD会覆盖默认逻辑导致异常。修改Dockerfile如下：

FROM tiangolo/uvicorn-gunicorn-fastapi:python3.10

WORKDIR /app

COPY requirements.txt /app
RUN pip install -r requirements.txt

COPY . /app
# 无需添加自定义CMD，镜像会自动识别并启动main:app

方法2：修改CMD使用环境变量端口 #

若坚持自定义启动命令，需确保监听PORT环境变量（本地可设置默认值，Cloud Run会自动覆盖）：

FROM tiangolo/uvicorn-gunicorn-fastapi:python3.10

WORKDIR /app

COPY requirements.txt /app
RUN pip install -r requirements.txt

COPY . /app

# 设置本地默认端口，Cloud Run部署时会自动替换
ENV PORT=8001
# 使用shell格式CMD解析环境变量
CMD uvicorn main:app --host 0.0.0.0 --port ${PORT}

额外排查步骤 #

• 本地模拟验证：启动容器时传入PORT变量，确认服务可正常运行：

  docker build -t fastapi-test .
  docker run -p 8001:8001 -e PORT=8001 fastapi-test
  

• 查看Cloud Run日志：在Cloud Run控制台进入对应服务的日志页面，检查容器启动阶段的具体错误（如依赖缺失、模块路径错误等），定位深层问题。

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