Go 的 http.Pusher 仅在 HTTP/2 下生效，需 HTTPS、TLS 配置 ALPN 支持 h2，且仅限 GET/HEAD 请求；Push 路径须为同域绝对路径，必须在 WriteHeader 前调用，并注意现代浏览器已弱化甚至禁用该特性。
Go 的 http.Pusher 在 HTTP/2 下才真正生效
HTTP/2 服务器推送（Server Push）不是靠 Go 自己“模拟”出来的，它依赖底层 TLS 连接协商出 HTTP/2 协议；如果客户端没走 HTTPS、或 TLS 配置没启用 ALPN（比如没设 NextProtos: []string{"h2"}），http.Pusher 就是 nil，强行调用会 panic。
常见错误现象：panic: interface conversion: http.ResponseWriter is *http.response not http.Pusher —— 这说明当前请求根本没跑在 HTTP/2 上。
- 必须用 HTTPS 启动服务（HTTP/1.1 不支持 Push）
- 使用
http.Server时，TLSConfig要显式设置NextProtos: []string{"h2", "http/1.1"} - 浏览器地址栏必须输
https://，且服务端证书要可信（自签证书需手动信任，否则 Chrome 会降级到 HTTP/1.1）
http.Pusher.Push() 的路径必须是绝对路径，且需匹配同域
Push 不是发个资源就完事，它本质是“预发一个同域的 HTTP 请求”，所以 Push() 第一个参数是 path，不是文件名，也不是 URL；而且这个 path 必须以 / 开头，否则直接报错 http: invalid push target path。
示例中常见写错：pusher.Push("style.css", nil) → 错，缺斜杠；pusher.Push("/assets/style.css", nil) → 对，但前提是当前页面本身也由同域名提供（如 https://example.com/index.html），否则浏览器会拒绝接收。
立即学习“go语言免费学习笔记（深入）”；
- 相对路径（如
"./script.js"）或协议完整 URL（如"https://cdn.example.com/logo.png"）都会触发 panic - 被 push 的资源，响应状态码必须是 200，且 Content-Type 建议明确设置，否则浏览器可能不缓存
- 不要 push 大文件（如 >1MB 的视频），HTTP/2 流有优先级和流控，盲目 push 反而拖慢首屏
不是所有响应都支持 Push：仅限 GET 请求且未写 header
Push 必须在 handler 写入任何响应体之前调用，一旦 WriteHeader() 或 Write() 执行过，response 已进入发送阶段，Pusher 就失效了。这也是为什么很多人在模板渲染后才想起来 push，结果白忙活。
另一个限制：只有原始请求方法是 GET 或 HEAD 时，Pusher 才非 nil；POST/PUT 等请求下 Pusher 恒为 nil，这是 HTTP/2 规范强制要求的 —— 推送只能用于获取性操作，不能触发副作用。
- 务必在 handler 开头检查：
pusher, ok := w.(http.Pusher); if !ok { /* fallback */ } - 避免在中间件里提前写 header（比如日志中间件调了
w.WriteHeader(200)），这会让后续 handler 拿不到 Pusher - 如果用了
http.StripPrefix或路由库（如gorilla/mux），确保 push 路径是最终解析后的路径，而非原始 URL
Chrome 和 Firefox 已逐步弱化 Server Push 支持，别强依赖
从 Chrome 96 开始，http.Pusher 虽然还能用，但浏览器不再自动缓存 push 资源，也不再提升加载优先级；Firefox 更早一步，在 2022 年就默认禁用。这意味着你代码里写了 push，用户实际感受可能毫无差别，甚至因多推了冗余资源而浪费带宽。
目前更推荐的替代方案是：用 <link rel="preload"> + HTTP/2，或直接升级到 HTTP/3（IETF 已废弃 Server Push）。如果你还在维护老项目，只对关键 CSS/JS 做 push，且确认客户端版本较旧（Chrome
- 别为了 push 而改架构 —— 比如把图片塞进 HTML 响应体里再 push，这反而破坏缓存
- 用
curl -v --http2 https://yoursite.com/看响应头是否有alt-svc，确认 HTTP/2 真启用了 - 真要验证 push 是否发出，得抓包看 HTTP/2 frames（Wireshark + nghttp2 解码），浏览器开发者工具 Network 面板已不显示 push 流
