使用Python解压GCS文件时如何配置项目参数与认证信息

你可以直接在初始化GCS客户端时显式传入项目ID、认证凭证参数，不需要依赖全局默认配置，具体修改如下：

核心配置说明 #

• 项目配置：初始化storage.Client时通过project参数指定目标GCP项目ID
• 认证配置：两种实现方式可选
  • 指定服务账号密钥路径：适合本地调试、固定账号场景，通过service_account.Credentials.from_service_account_file加载密钥文件后传入客户端
  • 默认凭证认证：如果已经通过gcloud CLI完成本地登录、或者运行在GCP服务（Cloud Function/GCE/GKE等）环境自带绑定服务账号，不需要显式传凭证，只传项目ID即可

修改后的完整代码 #

from google.cloud import storage
from google.oauth2 import service_account
from zipfile import ZipFile
from zipfile import is_zipfile
import io

def zipextract(bucketname, zipfilename_with_path, project_id, service_account_key_path=None):
    # 加载认证凭证
    creds = None
    if service_account_key_path:
        creds = service_account.Credentials.from_service_account_file(service_account_key_path)
    
    # 初始化客户端时显式传入项目和认证配置
    storage_client = storage.Client(
        project=project_id,
        credentials=creds
    )
    bucket = storage_client.get_bucket(bucketname)

    destination_blob_pathname = zipfilename_with_path
    
    blob = bucket.blob(destination_blob_pathname)
    zipbytes = io.BytesIO(blob.download_as_string())

    if is_zipfile(zipbytes):
        with ZipFile(zipbytes, 'r') as myzip:
            for contentfilename in myzip.namelist():
                contentfile = myzip.read(contentfilename)
                blob = bucket.blob(zipfilename_with_path + "/" + contentfilename)
                blob.upload_from_string(contentfile)

# 调用示例
if __name__ == "__main__":
    # 替换为实际配置
    GCP_PROJECT_ID = "your-gcp-project-id"
    # 本地调试时填写服务账号密钥路径，生产环境部署在GCP服务内可传None使用默认绑定凭证
    SA_KEY_PATH = "/local/path/to/your/service-account-key.json"
    zipextract(
        bucketname="mybucket",
        zipfilename_with_path="path/file.zip",
        project_id=GCP_PROJECT_ID,
        service_account_key_path=SA_KEY_PATH
    )

注意事项 #

• 所用的认证账号需要提前授予目标存储桶的对象读写权限，否则会出现403权限报错
• 生产环境不建议把服务账号密钥文件硬编码在代码中，优先使用GCP原生的工作负载身份机制做认证，避免密钥泄露风险
• 如果不想在代码里传参，也可以提前在系统环境变量设置GOOGLE_CLOUD_PROJECT为项目ID、GOOGLE_APPLICATION_CREDENTIALS为密钥文件路径，storage.Client()会自动读取这两个环境变量的配置完成初始化

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