求助：Python中AWS S3事件通知的类型提示与Pydantic解析支持

1. 使用 aws-lambda-powertools 的 S3 事件类型 #

该库虽为Lambda场景设计，但S3通过SQS发送的事件通知结构与Lambda接收的完全一致，其提供的类型可直接用于类型提示和Pydantic解析：

• 安装依赖：

pip install aws-lambda-powertools

• 代码示例：

from aws_lambda_powertools.utilities.data_classes import S3Event
import json

# 从SQS消息中提取事件内容（实际场景中从SQS获取消息体）
sqs_message_body = '{"Records": [...]}'
s3_event = S3Event(json.loads(sqs_message_body))

# 带类型提示的事件处理函数
def process_object_created_event(event: S3Event) -> None:
    for record in event.records:
        if record.event_name.startswith("s3:ObjectCreated:"):
            bucket = record.s3.bucket.name
            obj_key = record.s3.object.key
            print(f"处理新创建对象: s3://{bucket}/{obj_key}")

2. 使用 pydantic-aws 专用Pydantic模型 #

此库专门提供AWS服务相关的Pydantic模型，包含完整的S3事件通知结构定义：

• 安装依赖：

pip install pydantic-aws

• 代码示例：

from pydantic_aws import S3EventNotification
import json

sqs_message_body = '{"Records": [...]}'
s3_event = S3EventNotification.parse_raw(sqs_message_body)

for record in s3_event.Records:
    if record.event_name.startswith("s3:ObjectCreated:"):
        print(f"检测到对象创建事件: {record.s3.object.key}")

3. 关于 types-aiobotocore-s3 的说明 #

types-aiobotocore-s3 仅提供S3 API调用相关的类型（如客户端方法的请求/响应结构），并不包含S3事件通知的格式类型——这类跨服务通知的结构不属于SDK调用范畴，因此无法在该库中找到。

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