trailer头必须配合chunked编码使用，需在writeheader前声明trailer字段、writeheader后用trailerprefix+字段名写值，并确保响应器支持flush且中间件透传。
Trailer 头必须配合 chunked transfer encoding 使用
HTTP/1.1 的 Trailer 头本身不传输实际值，它只是声明“后面 chunked 编码的 trailer 部分会包含哪些字段”。所以如果响应没启用 chunked（比如设置了 Content-Length 或写了固定长度 body），Trailer 头会被忽略，且 Go 的 net/http 在写入时会直接丢弃它。
正确做法是：不设 Content-Length，不调用 WriteHeader 传入状态码后立刻写 body；而是让 Go 自动选择 chunked 编码——这要求你调用 WriteHeader 后，**不关闭连接、不写完全部 body、不显式 flush**，然后在最后调用 Flush 或让 handler 返回。
- 确保 handler 中没设置
Content-Length（包括没调用w.Header().Set("Content-Length", ...)） - 调用
w.Header().Set("Trailer", "X-Checksum, X-Duration")必须在w.WriteHeader之前 - body 写入过程不能提前结束（例如 panic、return、或显式
http.CloseNotifier干预）
使用 net/http.TrailerPrefix 设置 trailer 字段值
net/http.TrailerPrefix 是一个字符串常量，值为 "Trailer:"，它**不是用来“开启 trailer”或“注册字段”的函数**，而是供你在写 trailer 值时构造 header key 的前缀。Go 要求所有 trailer 字段名必须以该前缀开头，否则 WriteHeader 或 Flush 时会被静默过滤掉。
真正写 trailer 值的方式是：在 WriteHeader 之后、Flush 之前，往 w.Header() 里写键为 TrailerPrefix + 字段名 的项。
w.Header().Set("Trailer", "X-Checksum")
w.WriteHeader(http.StatusOK)
fmt.Fprint(w, "some streaming body...")
// ...
w.Header().Set(net/http.TrailerPrefix+"X-Checksum", "sha256:abcd1234")
w.(http.Flusher).Flush()
- 字段名大小写敏感，
X-Checksum和x-checksum视为不同字段 - 必须和
Trailer头中声明的字段完全一致（包括拼写与大小写） - 不能在
WriteHeader前写 trailer 值，否则会被清空
常见错误：Trailer 值没出现在响应末尾
最常遇到的现象是：代码看着都对，但抓包发现响应结尾没有 trailer block，或者 trailer 字段为空。原因通常有三个：
- handler 返回太快，body 写完就结束了，Go 没机会输出 trailer（需确保有显式
Flush或足够延迟） -
Trailer头声明了X-Checksum，但写值时用了TrailerPrefix + "x-checksum"（大小写不匹配） - 服务器 behind nginx / envoy，默认会 strip 所有 trailer，需显式配置透传（如 nginx 加
underscores_in_headers on;和proxy_pass_request_headers on;）
验证是否生效，最简单方式是用 curl -v 看响应末尾是否有类似 X-Checksum: sha256:... 的独立行（在 0\r\n\r\n 之后）。
注意 http.ResponseWriter 是否支持 Flush
不是所有 http.ResponseWriter 实现都支持 Flush。标准 net/http server 提供的是 *response，它实现了 http.Flusher；但如果你在中间件里包装了 responseWriter，或用了某些测试框架（如 httptest.ResponseRecorder），它**不实现 Flusher 接口**，此时调用 Flush() 会 panic 或静默失败。
安全写法是类型断言：
if f, ok := w.(http.Flusher); ok {
f.Flush()
} else {
// fallback：记录警告，或改用其他流式策略
}
Trailer 的实际价值高度依赖客户端和中间件支持，别假设它一定能被端到端传递。真要传校验值或元数据，优先考虑放在 body 末尾 JSON 或固定分隔格式里，更可靠。
