如何通过HTTP请求头传递自定义唯一ID关联API Gateway与Lambda日志？

• 前端添加自定义请求头：前端发起请求时，在HTTP请求头中加入唯一标识（比如X-Request-ID），值用UUID类方法生成（比如前端用crypto.randomUUID()），保证每个请求的ID唯一。

• API Gateway传递请求头：

  • 若使用REST API：在集成请求的「HTTP Headers」配置中，添加映射规则，将method.request.header.X-Request-ID映射到目标头（或直接传递到Lambda的event参数中）。
  • 若使用HTTP API：默认会把所有请求头包含在Lambda的event对象headers字段里，无需额外配置，只要确保API Gateway没有过滤该自定义头。

• Lambda函数记录ID：在Lambda代码中从event里取出这个ID（比如Node.js取event.headers['X-Request-ID']，Python取event['headers']['X-Request-ID']），然后在所有日志输出中带上该ID。例如：

  const requestId = event.headers['X-Request-ID'];
  console.log(`[${requestId}] 开始处理请求`);
  // 业务逻辑代码
  console.log(`[${requestId}] 请求处理完成`);
  

• 快速定位日志：前端开发人员需要排查问题时，提供对应的X-Request-ID，直接在CloudWatch日志中搜索该ID，就能精准找到该请求对应的所有Lambda日志，高并发场景下也能快速定位。

注意事项 #

• 若涉及CORS请求，需在API Gateway的CORS配置中，将X-Request-ID加入「Allowed Headers」列表，避免浏览器拦截请求。
• 也可以使用API Gateway自动生成的X-Amzn-Trace-Id，但自定义ID的优势是前端可直接生成并持有，更方便自身追踪请求。

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