请求 ID（关联 ID）

请求 ID 由边缘端（负载均衡器、网关或初始服务）生成，并以 X-Request-Id 等响应头的形式返回。处理该请求时写入的每条日志都会包含此 ID，当请求分发到其他服务时，该 ID 也会随之传递，以便稍后重新构建整个请求路径。

工作原理

客户应在报告任何错误时记录错误 ID，并将其包含在错误报告中；这样，支持人员就能在几秒钟内找到确切的服务器端日志。分布式追踪标准（例如 W3C Trace Context，即 traceparent 标头）也采用了相同的理念，通过添加父级和子级跨度来计时。

误解

时间戳和端点足以在日志中找到相应的请求。在繁忙的系统中，每秒都会有数千个相同的调用。如果没有 ID， "it failed around 10:42"描述只能算是搜索，而无法进行查找。

点击这里试试

实时后端会在每个响应中设置 X-Request-Id 标头，并在 JSON 正文中包含相同的 requestId，包括在其 500 错误中，这是它唯一公开的细节。

相关内容

• HTTP 500 Internal Server Error
• HTTP 标头

资料来源

• Traces and context — OpenTelemetry

其他术语

• HTTP 标头 — 每个请求和响应都会发送名称-值元数据，与请求体分开。
• Webhook — 服务器在发生某些事情时向您发送的 HTTP 回调，而不是让您轮询询问。
• HMAC签名 — 一个带有密钥的哈希值证明有效载荷来自持有共享密钥的人，并且没有被篡改。
• 服务器发送事件 (SSE) — 通过普通的 HTTP 响应，从服务器到客户端单向传输事件流，并且响应保持打开状态。

阅读英文版

所有术语 · 测试技巧 · 全部 39 个模拟 REST API

最后更新时间 2026年10月16日