Lambda@Edge事件是否会批量到达？需解析完整Records数组吗？

核心结论 #

Lambda@Edge 不会以批量形式传递事件，每个Lambda调用只会包含单个事件记录，所以直接使用const request = event.Records[0].cf.request;是完全安全且符合生产要求的。

详细说明 #

CloudFront的Lambda@Edge触发逻辑是针对每一个用户请求单独调用Lambda函数，不管是源请求、查看请求、错误响应还是其他触发场景，传递给函数的event.Records数组永远只会有1个元素。

官方示例中使用Records[0]，是因为Lambda事件格式遵循AWS通用的Records结构（和S3等支持批量事件的服务格式对齐），但Lambda@Edge的触发机制从设计上就不支持批量事件传递。

实践建议 #

虽然当前不需要遍历整个Records数组，但如果希望代码更健壮（比如极端情况下AWS调整触发逻辑的小概率场景），可以添加简单的遍历逻辑：

for (const record of event.Records) {
  const request = record.cf.request;
  // 处理请求逻辑
}

不过在实际生产环境中，直接使用Records[0]已经足够可靠，官方示例也一直采用这种写法。

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