Beego静态资源必须交由Nginx接管而非框架内置处理，否则CDN回源走Go runtime导致性能瓶颈、缓存失效；需禁用Beego StaticDir、Nginx用alias精准映射/static/路径、强制注入immutable头、CDN忽略干扰查询参数、publicPath指向CDN完整域名。
Beego 默认把静态资源（如 static/js、static/css）直接由框架内部 http.ServeFile 或 beego.BConfig.WebConfig.StaticDir 路由处理，不经过 Nginx —— 这意味着你配了 CDN，但源站回源请求仍走 Go runtime，性能瓶颈和缓存头控制权都在 Beego 层，极易导致回源慢、缓存失效、CDN 命中率低。
Beego 中静态资源必须交由 Nginx 处理，而非框架内置服务
Beego 的 StaticDir 配置本质是注册一个 HTTP handler，所有静态请求都经 Go runtime 分发，无法利用 Nginx 的零拷贝 sendfile、高效缓存头注入、连接复用等能力。CDN 回源时若直打 Beego，会放大 GC 压力、阻塞 goroutine，尤其在高并发小文件场景下，http.Server 响应延迟可能飙至 200ms+。
正确做法是：禁用 Beego 静态路由，让 Nginx 完全接管 /static/ 路径：
- 在
conf/app.conf中注释或删除staticdir = "static"行 - 确保 Beego 路由不匹配
/static/.*，避免beego.Router("/static/*s", &controllers.StaticController{})类配置残留 - Nginx 的
location /static/必须置于 server 块中，且root指向真实文件路径（如/var/www/myapp/static），不是 Beego 项目根目录
Nginx 缓存头必须含 immutable，否则 CDN 不识别资源不可变性
CDN（尤其是百度智能云、阿里云）对 Cache-Control: public, max-age=31536000 仅视为“可缓存”，但不会跳过 ETag/Last-Modified 验证；只有加上 immutable，CDN 才敢在 TTL 内完全跳过条件请求，真正降低回源率。
Beego 本身不支持自动注入 immutable，必须由 Nginx 强制添加：
location ~* ^/static/(.+)\.(js|css|png|jpg|gif|woff2|ttf|eot|svg|webp)$ {
alias /var/www/myapp/static/$1.$2;
expires 1y;
add_header Cache-Control "public, immutable";
add_header X-Content-Type-Options nosniff;
try_files $uri =404;
}注意：alias 和 root 行为不同，这里用 alias 更安全，避免路径拼接错误；若用 root，需写成 root /var/www/myapp; + location /static/ { ... }，否则易 404。
CDN 缓存键必须忽略构建哈希参数，否则每次部署都击穿缓存
前端构建（如 Webpack/Vite）生成的文件名常带 hash，例如 main.a1b2c3.js，但 URL 中若还拼了无关参数（如 ?v=20260821 或 &utm_source=ad），CDN 会把带参和不带参视作两个 key，导致缓存冗余、命中率下降。
百度智能云/腾讯云 CDN 控制台均支持「忽略指定查询参数」功能，务必开启：
- 在缓存规则中设置「忽略参数」为
v,utm_source,spm,rd等常见干扰项 - 若用自定义缓存键（Cache Key），显式声明只包含
Host + URI，排除$args - 验证方式：用
curl -I https://static.example.com/main.a1b2c3.js?v=20260821和curl -I https://static.example.com/main.a1b2c3.js，响应头中X-Cache应均为HIT（非第一次请求）
Beego 构建产物的 publicPath 必须指向 CDN 域名，而非相对路径
前端打包工具（Vue CLI、Webpack）的 publicPath 若设为 /static/ 或 ./，生成的 HTML 中 JS/CSS 地址仍是源站路径，CDN 完全不生效。
必须改为完整 CDN 域名：
- Webpack：在
vue.config.js中设publicPath: "https://static.example.com/" - Vite：在
vite.config.ts中设base: "https://static.example.com/" - Beego 模板中引用静态资源时，也应使用绝对 CDN 地址，例如
<script src="https://static.example.com/js/app.js"></script>，而非<script src="{{.StaticUrl}}/js/app.js"></script>
遗漏这点，等于白配 CDN —— 浏览器仍从源站拉资源，所有优化归零。
最易被忽略的是 Nginx 的 alias 路径与前端 publicPath 的严格对应关系：前者决定回源时文件从哪读，后者决定浏览器从哪下，两者域名、路径结构、末尾斜杠必须完全一致，差一个字符就 404 或混源加载失败。
