首页/网络/协议速查/Trailer 尾部字段声明
HTTP 头与缓存70 条

Trailer 尾部字段声明

声明在 chunked 报文尾部(body 之后)出现的字段名,常用于响应完成前无法确定的元数据(如摘要、耗时)。

协议速查网络更新于 2026-10-12
名称Trailer
作用预告尾部字段集合
规范RFC 9110 §6.5.1
前提报文使用分块传输;接收方需 TE: trailers 支持

消息结构

消息结构
HTTP/1.1 200 OK
Transfer-Encoding: chunked
Trailer: Server-Timing

5\r\nhello\r\n0\r\nServer-Timing: db;dur=53\r\n\r\n
gRPC 用 trailer 传 grpc-status/grpc-message;网关必须完整转发分块尾部,否则调用方解析失败。

易错点

  • Nginx 默认会丢弃部分 trailer,gRPC 场景需确认代理支持(http2 + grpc_pass)

数据来源与参考

  • RFC 9110 §6.5.1 Trailer
  • RFC 9112 §7.1.2

相关工具

​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌