部署对接Google Cloud Storage的Flask应用至Cloud Run遇503错误

1. 修复服务账号密钥的致命问题 #

你的代码硬编码了本地服务账号密钥路径，这在Docker容器和Cloud Run环境中完全无效：

# 错误写法：本地路径在容器中不存在
storage_client = storage.Client.from_service_account_json('/home/hajnyondra/hello-world-1/test22-401315-883f659ea7a6.json')

正确做法：

• 删除本地密钥文件的硬编码，改用Cloud Run默认服务账号权限：

  # 自动读取Cloud Run环境的默认服务账号凭证
  storage_client = storage.Client()
  

• 部署时给Cloud Run服务授予GCS存储桶权限：在部署命令中添加--service-account参数，或在Cloud Console中给Cloud Run默认服务账号添加Storage Object Admin（或更细粒度的Storage Object Creator+Storage Object Viewer）角色，确保它能访问json_uloziste存储桶。

2. 延迟GCS客户端初始化，避免启动失败 #

当前代码在模块加载阶段就初始化GCS客户端和存储桶，若权限不足或网络异常，会直接导致应用启动崩溃，Cloud Run检测不到健康实例就会返回503。

修改代码：
把GCS初始化移到函数内部，采用懒加载方式：

app = Flask(__name__)

# 仅定义变量，不提前初始化
storage_client = None
BUCKET = None
bucket_name = 'json_uloziste'

def get_storage_client():
    global storage_client
    if not storage_client:
        storage_client = storage.Client()
    return storage_client

def get_bucket():
    global BUCKET
    if not BUCKET:
        client = get_storage_client()
        BUCKET = client.get_bucket(bucket_name)
    return BUCKET

# 调整create_json和get_json函数，调用get_bucket()
def create_json(json_object, filename):
    bucket = get_bucket()
    blob = bucket.blob(filename)
    # 后续代码保持不变...

def get_json(filename):
    bucket = get_bucket()
    blob = bucket.get_blob(filename)
    # 后续代码保持不变...

3. 确认模板文件正确复制到容器 #

根路径/依赖render_template('index.html')，若index.html不在容器内的templates目录下，会导致请求根路径时抛出错误，影响Cloud Run健康检查。

验证项目结构：
确保项目目录结构如下：

你的项目/
├── main.py
├── Dockerfile
├── requirements.txt
└── templates/
    └── index.html

Dockerfile中的COPY . ./会将整个项目目录复制到容器/app下，只要结构正确，模板就能被Flask识别。

4. 清理生产环境不必要的依赖 #

debugpy仅用于本地调试，生产环境无需保留，从requirements.txt中删除：

Flask
requests
gunicorn
google-cloud-storage

5. 验证Cloud Run基础配置 #

• 端口配置：你的gunicorn命令--bind :$PORT正确，Cloud Run会自动设置PORT环境变量。
• 健康检查：默认使用根路径/作为健康检查端点，若根路径存在问题，可添加专门的健康检查接口：

  @app.route('/health')
  def health_check():
      return "OK", 200
  

  之后在Cloud Console的Cloud Run服务设置中，将健康检查路径改为/health。

6. 通过日志定位具体错误 #

若部署后仍返回503，务必查看Cloud Run日志：

• 打开Cloud Console，找到目标Cloud Run服务，点击「日志」标签。
• 查看启动日志，通常能找到应用启动失败的具体原因（如权限错误、文件缺失、依赖问题等）。

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