在GCP Cloud Run部署Flask应用失败：容器未监听指定端口

问题分析 #

部署时出现的错误核心原因是容器未正确监听Cloud Run指定的PORT=80端口，大概率是gunicorn命令未正确解析环境变量$PORT，或是容器启动逻辑导致端口绑定失败。

解决方案 #

1. 修改Dockerfile确保环境变量正确解析 #

Cloud Run会自动注入PORT变量，但容器内的命令执行环境可能无法直接展开该变量。调整Dockerfile的CMD指令，确保$PORT被正确解析：

修改后的Dockerfile：

FROM python:3.11
ENV PYTHONUNBUFFERED True
ENV PORT 8080  # 设置默认端口，兼容本地测试和Cloud Run的自动覆盖

ENV APP_HOME /app
WORKDIR $APP_HOME
COPY . ./
RUN pip install -r requirements.txt
RUN pip install gunicorn  
# 通过shell执行命令，保证$PORT被正确解析
CMD ["sh", "-c", "exec gunicorn --bind :$PORT --workers 1 --threads 8 --timeout 0 main:app"]

2. 本地模拟Cloud Run环境验证 #

重新构建镜像后，先在本地模拟Cloud Run的PORT=80环境测试：

# 重新构建镜像
docker build -t my-flask-app .
# 模拟Cloud Run的端口配置运行容器
docker run -e PORT=80 -p 8080:80 my-flask-app

访问http://localhost:8080确认应用正常响应后，再推送镜像至Artifact Registry。

3. 查看Cloud Run日志定位具体错误 #

如果问题仍存在，通过日志查看容器启动时的详细报错：

gcloud run logs read --service my-flask-app --region europe-west3 --latest

常见错误场景包括：

• gunicorn无法找到main:app实例（检查main.py是否正确定义app = Flask(__name__)）
• 依赖包缺失（确认requirements.txt包含所有必要依赖）
• 端口被占用（确保容器内无其他进程占用指定端口）

4. 重新执行部署流程 #

完成上述调整后，重新推送镜像并部署：

# 为镜像打标签
docker tag my-flask-app europe-west3-docker.pkg.dev/propane-nomad-396712/cloud-run/my-flask-app
# 推送镜像至Artifact Registry
docker push europe-west3-docker.pkg.dev/propane-nomad-396712/cloud-run/my-flask-app
# 部署到Cloud Run
gcloud run deploy my-flask-app \
--image europe-west3-docker.pkg.dev/propane-nomad-396712/cloud-run/my-flask-app \
--platform managed \
--allow-unauthenticated

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