拥有Editor权限，GCS触发的Python Gen2云函数为何无执行/日志？

问题背景 #

在loadsnap-prod项目（ID：266229951076，区域us-central1）中，配置了GCS存储桶gs://loadsnap-prod-tickets的文件上传触发Python 3.11 Gen2云函数parse-ticket-v2。文件上传后，Cloud Logging中出现对应时间的Cloud Run请求日志，但函数代码内的所有日志（包括模块级的--- main.py module loaded ---、函数入口的--- parse_ticket_handler function started ---等基础日志）均未输出。底层Cloud Run服务状态健康，已通过启动探测。

当前部署的极简测试代码：

import functions_framework
import logging
import sys
import traceback # Import traceback module

# --- Test Log 1: Module Level ---
logging.basicConfig(level=logging.INFO)
logging.info("--- main.py module loaded ---")

@functions_framework.cloud_event
def parse_ticket_handler(cloud_event):
    """
    Bare minimum function to test invocation, with enhanced logging.
    """
    # --- Test Log 2: Handler Level ---
    logging.info("--- parse_ticket_handler function started ---")

    try:
        # --- Test Log inside try ---
        event_id = cloud_event["id"]
        event_type = cloud_event["type"]
        logging.info(f"Received event ID: {event_id}, Type: {event_type}")
    except Exception as e:
        # --- Test Log 3: Error Handling ---
        logging.error(f"!!! EXCEPTION in parse_ticket_handler: {e}", exc_info=True)
        raise

    # --- Test Log 4: Handler End ---
    logging.info("--- parse_ticket_handler function finished ---")
    return None

排查与解决步骤 #

• 检查日志过滤范围
  默认日志视图可能仅展示特定维度的日志，切换到Cloud Run > 服务 > parse-ticket-v2的专属日志页面，或在Cloud Logging中使用宽泛过滤条件：

  resource.type="cloud_run_revision"
  resource.labels.service_name="parse-ticket-v2"
  

  同时确认未误过滤INFO级别日志，确保日志级别筛选器设置为INFO或更低。

• 验证函数入口配置
  部署云函数时，确认入口点参数已设置为parse_ticket_handler，且@functions_framework.cloud_event注解与GCS事件的Cloud Event类型匹配。若入口函数指定错误，会直接导致代码无法执行。

• 修复日志配置冲突
  Cloud Functions Gen2基于Cloud Run，平台已默认配置日志系统，手动调用logging.basicConfig()可能覆盖或干扰原有配置。移除该行代码，改用直接设置日志级别：

  logging.getLogger().setLevel(logging.INFO)
  

• 排查启动阶段静默失败
  模块级代码加载时若出现异常，会导致函数初始化失败，但Cloud Run启动探测仅检查服务可用性，不会捕获代码加载错误。在Cloud Logging中搜索包含crash或exception的日志，或本地模拟运行函数测试：

  functions-framework --target=parse_ticket_handler --signature-type=cloudevent
  

  发送模拟GCS事件请求，观察本地是否有日志输出或报错。

• 确认触发器权限与事件类型
  确保GCS触发器配置的事件类型为google.cloud.storage.object.v1.finalized（文件上传完成事件），同时云函数的服务账号拥有storage.objects.get权限，避免因权限不足导致事件处理提前终止但无日志输出。

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