GCP Gen1非HTTP云函数本地测试遇401，直接运行脚本正常

核心问题出在函数签名与触发方式不匹配，导致GitHub PAT密钥被意外覆盖，最终触发401未授权错误：

为什么会出现401？ #

你的云函数是Pub/Sub触发的非HTTP函数，但存在以下冲突：

1. 本地functions-framework运行：框架默认将未声明标准触发参数的函数当作HTTP函数处理，会自动把Flask的request请求对象作为第一个参数传入requestGHA。而你的函数第一个参数是PAT=PAT，这就导致原本的密钥被替换成了HTTP请求对象，GitHub API收到的Authorization头变成无效的Bearer <Request ...>，直接返回401。
2. GCP函数UI测试页：测试非HTTP函数时，页面会传入模拟的Pub/Sub event对象作为第一个参数，同样覆盖了PAT参数，导致密钥失效。
3. 真实Pub/Sub触发正常：GCP会兼容未声明event/context参数的非HTTP函数，调用时不传入额外参数，函数能正常使用PAT的默认环境变量值，所以运行正常。

解决方案 #

方案1：修改函数签名适配两种触发场景 #

将函数改为非HTTP触发的标准签名格式，同时保留参数默认值，兼顾真实触发和本地测试：

import requests
import os
from dotenv import load_dotenv

load_dotenv()
OWNER = os.environ['OWNER']
REPO = os.environ['REPO']
EVENT_TYPE = os.environ['EVENT_TYPE']
PAT = os.environ['PAT']

# 适配Pub/Sub触发的标准签名，同时保留参数默认值
def requestGHA(event=None, context=None, PAT=PAT, OWNER=OWNER, REPO=REPO, EVENT_TYPE=EVENT_TYPE):
    headers = {
        "Accept": "application/vnd.github+json",
        "Authorization": f"Bearer {PAT}",
    }
    url = f"https://api.github.com/repos/{OWNER}/{REPO}/dispatches" 
    payload = {
        "event_type": EVENT_TYPE,
        "client_payload": {
            "db_schema": "dev"
        }
    }
    response = requests.post(url, json=payload, headers=headers)
    return str(response.status_code)

修改后：

• Pub/Sub触发时，GCP传入event和context，不影响PAT等参数的默认值。
• 本地用functions-framework运行时，HTTP请求对象会被传入event参数，PAT依然使用环境变量值，调用GitHub API正常。
• GCP UI测试页测试时，模拟的event传入第一个参数，同样不影响PAT取值。

方案2：本地测试用专门的HTTP包装函数 #

保留原有函数不变，新增一个HTTP触发的包装函数，避免参数覆盖：

# 原有requestGHA函数不变
def requestGHA(PAT=PAT, OWNER=OWNER, REPO=REPO, EVENT_TYPE=EVENT_TYPE):
    headers = {
        "Accept": "application/vnd.github+json",
        "Authorization": f"Bearer {PAT}",
    }
    url = f"https://api.github.com/repos/{OWNER}/{REPO}/dispatches" 
    payload = {
        "event_type": EVENT_TYPE,
        "client_payload": {
            "db_schema": "dev"
        }
    }
    response = requests.post(url, json=payload, headers=headers)
    return str(response.status_code)

# 本地测试用的HTTP包装函数
def http_test_wrapper(request):
    return requestGHA()

运行functions-framework时指定包装函数：

functions-framework --target http_test_wrapper --debug

访问http://localhost:8080/时，会通过包装函数调用正确的requestGHA，不会出现参数覆盖问题。

方案3：用GCP本地模拟器模拟真实触发 #

使用gcloud本地模拟器完全模拟Pub/Sub触发流程，避免HTTP适配问题：

1. 启动本地Pub/Sub模拟器：

gcloud beta emulators pubsub start

2. 设置环境变量指向模拟器：

$(gcloud beta emulators pubsub env-init)

3. 创建测试主题并发布消息：

gcloud pubsub topics create test-topic
gcloud pubsub topics publish test-topic --message "test"

4. 以事件触发模式运行函数：

functions-framework --target requestGHA --signature-type event --debug

验证方法 #

在函数中添加打印语句，确认PAT取值：

def requestGHA(...):
    print(f"Current PAT: {PAT}")
    # 原有逻辑

修改前用functions-framework运行并访问，会打印出类似<Request 'http://localhost:8080/' [POST]>的无效内容；修改后则会打印出你的PAT密钥（注意不要泄露），确认问题解决。

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