Flask迁移FastAPI后部署Cloud Run失败，排查发现Datastore项目配置问题

1. 先解决Datastore Client的项目ID问题 #

这是本地测试发现的明确错误，很大概率是导致Cloud Run启动失败的核心原因（端口提示可能只是应用未正常初始化的表象）。

• 显式指定项目ID：初始化Client时直接传入项目ID，避免依赖环境变量：

  from google.cloud import datastore
  
  # 替换成你的GCP项目ID
  client = datastore.Client(project="your-gcp-project-id")
  

• 通过环境变量传递项目ID：如果不想硬编码，可在部署时注入环境变量：

  • Dockerfile中添加：

    ENV GOOGLE_CLOUD_PROJECT=your-gcp-project-id
    

  • 或者Cloud Run部署命令中指定：

    gcloud run deploy your-service-name --set-env-vars GOOGLE_CLOUD_PROJECT=your-gcp-project-id --region your-region
    

  这样datastore.Client()会自动读取GOOGLE_CLOUD_PROJECT环境变量的值。

2. 修正Cloud Run端口监听配置 #

Cloud Run要求应用监听0.0.0.0和环境变量PORT指定的端口，FastAPI的启动代码必须符合这个要求：

import os
import uvicorn
from fastapi import FastAPI

app = FastAPI()

# 你的路由逻辑...

if __name__ == "__main__":
    # 优先读取PORT环境变量，默认用8080
    port = int(os.getenv("PORT", 8080))
    uvicorn.run(app, host="0.0.0.0", port=port)

对应的Dockerfile启动命令要确保正确解析PORT变量：

# 使用shell形式解析环境变量
CMD ["sh", "-c", "uvicorn main:app --host 0.0.0.0 --port $PORT"]

或者直接运行脚本：

CMD ["python", "main.py"]

3. 本地镜像验证 #

本地运行镜像时手动传入项目ID，确认应用能正常启动：

docker run -p 8080:8080 -e GOOGLE_CLOUD_PROJECT=your-gcp-project-id your-image-tag

访问http://localhost:8080，检查是否有Datastore相关的错误日志，确保应用初始化正常。

4. Cloud Run部署权限检查 #

• 确保Cloud Run服务使用的服务账号拥有Cloud Datastore User角色（或更高权限如Editor），否则会出现Datastore访问权限错误。
• 部署后查看Cloud Run的日志页面，确认启动日志中没有Datastore相关的OSError，端口问题会随着应用正常初始化自动解决。

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