为Cloud Run上的FastAPI配置环境变量：Docker设置无效解决方案

1. 验证Docker镜像内的环境变量配置 #

• 在Dockerfile中使用ENV指令定义环境变量，示例：

  ENV DATABASE_URL="postgresql://user:pass@host:port/db"
  ENV API_KEY="your-api-key"
  

• 构建镜像后本地测试：运行容器并调用FastAPI接口（比如自定义的/check-env接口），确认代码能正常读取到镜像内的环境变量。本地测试通过后再推送至容器镜像仓库。

2. 注意Cloud Run的环境变量优先级 #

Cloud Run会覆盖Docker镜像中定义的ENV变量，需确保部署时正确传递变量：

• 控制台部署：在「变量和秘密」选项卡中添加环境变量，键名需与代码中读取的完全一致（大小写敏感）。
• gcloud命令部署：使用--set-env-vars参数传递，示例：

  gcloud run deploy your-service-name \
    --image gcr.io/your-project-id/your-image-name \
    --set-env-vars DATABASE_URL="prod-db-url",API_KEY="prod-api-key"
  

3. 检查FastAPI代码的读取逻辑 #

• 确保代码使用正确的方式读取环境变量，示例：

  import os
  from fastapi import FastAPI
  
  app = FastAPI()
  
  @app.get("/check-env")
  def check_env():
      return {
          "DATABASE_URL": os.getenv("DATABASE_URL"),
          "API_KEY": os.getenv("API_KEY")
      }
  

• 避免用硬编码默认值覆盖预期的环境变量，比如os.getenv("KEY", "default")会导致默认值优先级高于Cloud Run传递的变量（如果代码逻辑未做特殊处理）。

4. 排查容器启动命令的影响 #

如果Cloud Run部署时指定了自定义启动命令，需确保该命令没有重置环境变量。比如不要在启动命令中使用env -i之类的指令清空环境。

5. 通过Cloud Run日志定位问题 #

部署后进入Cloud Run服务的日志页面，搜索环境变量相关输出，或查看FastAPI启动日志，确认变量是否被正确加载。

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