Go不直接渲染SPA，而是托管前端产物并提供后端服务；需用fallback handler处理前端路由刷新404问题，共享路由配置避免硬编码，并通过预渲染提升SEO与首屏性能。
Go 本身不直接渲染浏览器端的单页应用（SPA），它适合做后端 API 或静态文件服务器；真正的 SPA 渲染发生在浏览器中，由 JavaScript 框架（如 React、Vue、Svelte）完成。用 Go “开发 SPA”，本质是：用 Go 托管前端构建产物 + 提供配套后端服务。
如何用 net/http 正确托管 SPA 静态资源
常见错误是直接用 http.FileServer 服务 dist/ 目录，结果路由刷新 404——因为前端路由（如 /dashboard）是客户端逻辑，但服务器找不到对应物理文件。
- 必须用“fallback handler”：所有非静态资源请求（如
/api/xxx）走 API 路由；其余全部 fallback 到index.html - 推荐用
http.StripPrefix+ 自定义 handler，而非第三方中间件（避免隐式行为） - 静态文件需设置正确 MIME 类型和缓存头，否则 CSS/JS 可能加载失败或不更新
fs := http.FileServer(http.Dir("./dist"))
http.Handle("/static/", http.StripPrefix("/static/", fs))
http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
// 排除 API 和静态资源路径
if strings.HasPrefix(r.URL.Path, "/api/") || strings.HasPrefix(r.URL.Path, "/static/") {
return
}
http.ServeFile(w, r, "./dist/index.html")
})如何让 Go 后端与前端共享路由配置（避免硬编码）
前后端路由不一致会导致跳转失效或 API 请求错发。例如前端用 /users/:id，后端却暴露 /v1/user/{id}，维护成本陡增。
- 将公共路径前缀（如
/api/v1）抽成常量，在 Go 代码和前端环境变量（VITE_API_BASE_URL）中同步使用 - 对关键接口路径（如登录、用户信息），在 Go 中定义为 const，并生成 OpenAPI 文档，前端用
swagger-codegen或openapi-typescript-codegen自动生成 client SDK - 避免在前端拼接 URL 字符串，一律通过封装的
fetch工具函数注入 base path
如何处理 SPA 的 SEO 与首屏性能问题
纯客户端渲染的 Go 托管 SPA 默认无服务端 HTML 内容，搜索引擎抓取为空白，LCP（最大内容绘制）也易超时。
立即学习“go语言免费学习笔记（深入）”；
- Go 不适合做 SSR（React/Vue 的服务端渲染需 Node.js 运行时），但可做轻量级预渲染：构建时用 Puppeteer 或 Playwright 抓取关键路由（
/、/product/*），生成静态 HTML 存入dist/，Go 服务器优先返回这些预渲染页 - 务必设置
<meta name="robots" content="noindex">在非关键页面，防止预渲染页被误收录 - 前端构建产物启用
gzip或brotli压缩，Go 中用golang.org/x/net/http2启用 HTTP/2，并配http.Server{WriteTimeout: 30 * time.Second}防长连接阻塞
真正棘手的是跨域调试与构建流程耦合：本地开发时前端跑 vite dev server（端口 5173），后端 Go 服务（端口 8080）需配 CORS；上线又得切回静态托管模式。这个切换点最容易漏改配置，导致线上接口 403 或本地无法调用 API。
