Go 默认的 http.FileServer 不会为预压缩文件（如 .svgz）自动设置 Content-Encoding: gzip 响应头，导致浏览器解码失败；需自定义 Handler 显式添加头信息并使用 http.ServeFile。
go 默认的 `http.fileserver` 不会为预压缩文件（如 .svgz）自动设置 `content-encoding: gzip` 响应头，导致浏览器解码失败；需自定义 handler 显式添加头信息并使用 `http.servefile`。
在 Go 中直接使用 http.FileServer(http.Dir(...)) 服务 .svgz 文件时，虽然文件本身是 GZIP 压缩的 SVG（符合 SVGZ 规范），但标准 FileServer 仅基于文件扩展名或内容嗅探设置 Content-Type: image/svg+xml，却不会设置 Content-Encoding: gzip。这导致浏览器收到二进制压缩流后，误以为是未压缩的 UTF-8 文本，从而在解析 XML 时触发 “Encoding error”（如 error on line 1 at column 1）。
解决方法是绕过 FileServer 的自动逻辑，改用 http.ServeFile 并手动注入响应头。以下是一个完整、安全的示例 Handler：
package main
import (
"net/http"
"strings"
)
func svgzHandler(rootDir string) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
// 规范化路径，防止目录遍历（关键安全防护）
path := strings.TrimPrefix(r.URL.Path, "/")
if strings.Contains(path, "..") || strings.HasPrefix(path, "/") {
http.Error(w, "Forbidden", http.StatusForbidden)
return
}
fullPath := rootDir + "/" + path
// 仅对 .svgz 文件启用 gzip 编码
if strings.HasSuffix(strings.ToLower(path), ".svgz") {
w.Header().Set("Content-Type", "image/svg+xml")
w.Header().Set("Content-Encoding", "gzip")
// 禁用 Go 自动设置的 Content-Length（ServeFile 会正确计算）
w.Header().Del("Content-Length")
}
http.ServeFile(w, r, fullPath)
})
}
func main() {
http.Handle("/", svgzHandler("/srv/www/htdocs/"))
http.ListenAndServe(":9090", nil)
}
✅ 关键要点说明：
- 必须显式设置 Content-Encoding: gzip：这是浏览器识别并自动解压响应体的前提；
- Content-Type 应为 image/svg+xml（而非 application/gzip），因 SVGZ 本质仍是 SVG，只是传输层压缩；
- 禁用 Content-Length 头：http.ServeFile 内部会根据文件大小重设，若外部已设可能冲突；
- 路径校验不可省略：http.ServeFile 不做路径净化，需手动防御 ../ 目录穿越攻击；
- 不推荐全局启用 gzip：仅对 .svgz 等明确预压缩文件生效，避免对普通 .svg 或其他资源造成错误编码。
⚠️ 注意：SVGZ 已逐渐被现代 Web 实践弃用（HTTP/2+ 服务器压缩更通用），若条件允许，建议改用未压缩 .svg 配合 Nginx/Apache 的 gzip_static on 或 Go 中集成 golang.org/x/net/http2/h2c + 中间件动态压缩，兼顾兼容性与维护性。
