如何在GCS最终化事件触发的Python脚本中运行Bash脚本并排查无输出问题

我来帮你排查这个问题，你遇到的情况很常见，主要是几个细节没处理到位，咱们一步步来解决：

1. 先确认脚本路径和执行权限 #

首先，Cloud Functions的工作目录不一定是你脚本所在的目录，而且默认情况下alert.sh可能没有执行权限，这会导致脚本根本跑不起来。

解决办法： #

• 给alert.sh加上执行权限：部署前在本地执行chmod +x alert.sh，确保上传后脚本能被正常执行。
• 在Python里用绝对路径调用脚本，避免路径匹配问题：

import os
import subprocess

def hello_gcs_generic(data, context):
    # 获取当前Python脚本所在的目录
    script_dir = os.path.dirname(os.path.abspath(__file__))
    # 拼接alert.sh的绝对路径
    alert_script = os.path.join(script_dir, "alert.sh")
    # 用bash直接调用，避免权限或shell兼容问题
    subprocess.call(["bash", alert_script])

2. 捕获Bash脚本的输出到Cloud Logging #

默认情况下，Bash脚本的标准输出/错误输出不会自动进入Cloud Functions的日志系统（原Stackdriver），所以你看不到任何输出。得把脚本的输出捕获后用Python打印出来，才能在日志里看到。

修改后的Python代码： #

import subprocess
import os

def hello_gcs_generic(data, context):
    print('Event ID: {}'.format(context.event_id))
    print('Event type: {}'.format(context.event_type))
    
    script_dir = os.path.dirname(os.path.abspath(__file__))
    alert_script = os.path.join(script_dir, "alert.sh")
    
    try:
        # 捕获脚本的标准输出和错误输出
        result = subprocess.run(
            ["bash", alert_script],
            capture_output=True,
            text=True,
            check=True
        )
        # 打印脚本的输出到Cloud Logging
        print("=== Bash Script Output ===")
        print(result.stdout)
        # 如果有错误信息也打印
        if result.stderr:
            print("=== Bash Script Errors ===")
            print(result.stderr)
    except subprocess.CalledProcessError as e:
        # 脚本执行失败时打印错误详情
        print(f"Script failed with exit code {e.returncode}:")
        print(e.stdout)
        print(e.stderr)

3. 优化你的Bash脚本 #

给alert.sh加上shebang开头，确保用bash执行，再加点调试信息方便排查：

#!/bin/bash
echo "FILE ADDED - New file uploaded to GCS!"
# 打印当前工作目录，确认路径是否正确
echo "Current working directory: $(pwd)"
# 打印GCS相关的环境变量，验证触发上下文
echo "GCS Event Bucket: ${BUCKET_NAME:-Not set}"

4. 部署时注意事项 #

部署Cloud Function的时候，要确保alert.sh和main.py在同一个目录下，用gcloud functions deploy命令时，指定的source目录要包含这两个文件，不然Cloud Functions找不到你的bash脚本。

这样修改后，你再上传文件到GCS，就能在Cloud Logging里看到bash脚本的输出啦！

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