为何无法将flask.request.headers用作方法参数的类型提示？

错误原因 #

你把flask.request.headers这个实际运行时的请求头对象当成了类型提示来用。Python在解析函数定义阶段就会尝试访问flask.request.headers，但此时没有活跃的HTTP请求上下文，直接触发了RuntimeError。

正确的类型提示方案 #

Flask的请求头属于werkzeug.datastructures.Headers类型（具体请求场景下是其子类EnvironHeaders，但用父类Headers做类型提示足够通用）。需要先导入这个类型，再作为参数的类型标注。

修正后的代码 #

1. 导入类型 #

在定义events_webhook的文件顶部添加：

from werkzeug.datastructures import Headers

2. 修改函数定义 #

def events_webhook(header: Headers) -> None:
    """Webhook for Google Calendar events."""
    print(header)

3. 调用代码保持不变 #

你的路由调用代码没问题，继续正常传递request.headers即可：

@api.route('/calendar/event/webhook', methods=["POST"])
def gcalendar_event_webhook():
    try:
        if flask.request.method == "POST":
            return RestHandler.handle_success(
                gutils.events_webhook(request.headers),
                request=request, log_payload=False
            )
        else:
            return RestHandler.handle_exception(
                exception="Request method is not POST.", request=request
            )
    except Exception as exc:
        return RestHandler.handle_exception(exc, request)

额外说明 #

如果需要更精确的类型，可以用EnvironHeaders（同样从werkzeug.datastructures导入），但Headers已经能覆盖绝大多数场景，且兼容性更好。

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