如何通过Python获取本地及Cloud Run环境的当前GCP活跃项目名？

架构老林

2026-8-14

在Python中获取GCP当前活跃项目ID（支持本地与Cloud Run环境）

可以通过GCP官方的google-auth库实现，无需调用子进程，同时兼容本地开发环境和Cloud Run部署环境。

实现步骤

安装依赖
```
pip install google-auth
```

编写获取项目ID的代码

import google.auth

def get_gcp_project_id():
    try:
        # 自动识别环境配置：本地读取gcloud默认配置，Cloud Run读取元数据服务器
        credentials, project_id = google.auth.default()
        return project_id
    except google.auth.exceptions.DefaultCredentialsError:
        # 无有效配置时返回None或抛出异常，根据需求调整
        return None

使用示例

project_id = get_gcp_project_id()
if project_id:
    print(f"当前活跃项目ID：{project_id}")
else:
    print("未找到有效的GCP项目配置，请检查gcloud登录状态或服务账号权限")

原理说明

本地开发环境：google.auth.default()会自动读取gcloud config get-value project对应的默认配置（存储在~/.config/gcloud目录下），前提是你已经通过gcloud auth login完成认证。
Cloud Run部署环境：该函数会通过GCP元数据服务器获取当前服务所在的项目ID，无需额外配置，只要Cloud Run服务的默认服务账号拥有访问元数据的权限（默认已具备）。