Go服务需配合外部CDN：静态资源URL须配置驱动并用cdn_url函数拼接，禁用http.ServeFile而改用自定义FileServer设置缓存头与ETag，确保回源路径、响应头、协议处理与CDN配置一致，构建时替换优于运行时拼接。
Go 本身不提供 CDN 功能，所谓“CDN 部署”，本质是让 Go 服务生成正确 URL、返回合规响应头、并配合外部 CDN 服务协同工作。硬编码域名、忽略缓存头、把静态请求路由到 http.FileServer，都会导致 CDN 失效或回源暴增。
模板里怎么安全拼 CDN 路径
所有静态资源 URL 必须通过配置驱动，不能写死 https://cdn.example.com/js/app.js。否则本地调试 404、测试环境绕过 CDN、上线后路径多斜杠（如 //cdn.example.com//css/main.css）全都会发生。
- 约定 CDN 配置项（如
ALIYUN_CDN_DOMAIN或CLOUDFRONT_DOMAIN）末尾不带/ - 在 HTML 模板中用辅助函数统一拼接：
{{ cdn_url "/js/bundle.js" }}，内部逻辑为cdnBase + "/" + strings.TrimLeft(path, "/") - 开发环境可设为空字符串或
http://localhost:8080，避免混合内容（mixed content）被浏览器拦截 - CSS 中的
url()引用不会被模板函数处理，必须靠构建工具（如 Vite 的base配置或 Webpack 的publicPath）提前替换
为什么 http.ServeFile 和 CDN 不兼容
http.ServeFile 默认不设 Cache-Control、不写 ETag、不处理 If-None-Match，且对大文件不保证 Range 请求的正确响应。CDN 看不到有效缓存标识，只能每次都回源——等于没走 CDN。
- 改用
http.FileServer包裹自定义 handler，手动设置Cache-Control: public, max-age=31536000, immutable（适用于带哈希的 JS/CSS） - 关键响应头必须显式写出：
ETag（基于文件内容计算）、Last-Modified（用os.FileInfo.ModTime()）、Content-Type（用mime.TypeByExtension()推断） - 绝对禁止返回
Set-Cookie，哪怕只在 debug 模式下加了临时 cookie，CDN 也会跳过缓存 - 大文件（视频、下载包）必须支持
Range请求：确保用os.Open打开文件，且中间件未吞掉Range请求头
CDN 回源失败的三个高频原因
不是 Go 代码写错了，而是部署层配置脱节。线上抓包会发现 CDN 实际发来的请求路径和你本地开发时完全两样。
立即学习“go语言免费学习笔记（深入）”；
-
回源路径映射错位：CDN 控制台配置的回源路径是
/static/，但 Go 服务监听的是/assets/，结果所有请求 404；应在 Nginx 或 CDN 规则里统一重写为/static/再转发 -
源站响应头被覆盖：Nginx 默认会删掉
ETag或重写Cache-Control，需显式配置proxy_pass_request_headers on;和proxy_hide_header ETag;（反向操作） -
协议与 Host 判断失效：别在 Go 里用
r.Host做静态路由分发，CDN 回源时 Host 往往是源站 IP 或内网域名；应由 CDN 或 Nginx 完成路径分流，Go 只处理明确的/static/路由
构建阶段替换比运行时拼接更可靠
运行时拼接 URL 看似灵活，但一旦 CDN 域名配错、环境变量漏传、或模板忘记调用 cdn_url，就直接暴露本地路径。构建时替换是单点控制，出错即阻断。
- 对预编译前端产物（如 Vue/React 的
dist/index.html），用sed -i 's|/static/|https://cdn.example.com/static/|g'批量替换 - 对 Go 模板渲染的页面，用
go:embed加载 HTML 后，用strings.ReplaceAll()替换占位符（如{{CDN_BASE}}），再执行template.Parse - 上传到 CDN 前，务必验证替换结果：
grep -r "http://localhost" dist/应无输出；curl -I https://cdn.example.com/static/css/app.css应返回 200 + 正确缓存头
真正卡住人的从来不是怎么写 handler，而是 CDN 控制台缓存规则没配对、Nginx 把 ETag 给删了、或者 Range 请求被某层中间件静默截断——这些地方看不到 Go 代码，却决定加速成败。
