真正实现动静分离需确保请求路径匹配精准、静态资源缓存策略显式生效、后端代理链路完全断开;root/alias配置须正确,Cache-Control需always设置且避免上游覆盖,proxy_pass末尾斜杠影响路径转发,MIME类型须补充现代格式。

动静分离不是加个 location 就能生效的,关键在请求路径匹配逻辑、静态资源缓存策略和后端代理链路是否真正断开——很多配置看似正确,实则静态请求仍被转发到后端,压测时 QPS 上不去,根本原因就在这里。
怎么写 location 才算真正拦截静态请求
常见错误是用 location ~ \.(js|css|png|jpg|gif)$ 匹配,但没加 root 或 alias,导致 Nginx 找不到文件,最终 fallback 到 proxy_pass;或者用了 alias 却漏掉末尾斜杠,路径拼接出错返回 404。
-
root是拼接整个 URI 路径,比如root /var/www/html;+ 请求/static/js/app.js→ 实际找/var/www/html/static/js/app.js -
alias是完全替换匹配部分,比如location /static/ { alias /data/static/; }+ 请求/static/js/app.js→ 实际找/data/static/js/app.js(注意alias值末尾必须带斜杠) - 优先用
root,语义清晰;若需重映射目录结构,再用alias,但务必验证路径是否真实存在
为什么加了 expires 但浏览器仍发 If-Modified-Since 请求
这通常是因为响应头里同时存在 Cache-Control: no-cache 或 Cache-Control: max-age=0,它们优先级高于 expires。Nginx 默认不加 Cache-Control,但若 upstream 返回了该头,会直接透传,覆盖你的配置。
- 显式设置
add_header Cache-Control "public, max-age=31536000";(一年),并加always参数:add_header Cache-Control "public, max-age=31536000" always;,避免被 304/4xx 响应过滤 - 确认后端服务(如 Node.js/PHP)没主动输出冲突的
Cache-Control头 - 用
curl -I http://yoursite.com/logo.png检查响应头,确保只有你设定的缓存策略生效
proxy_pass 后端地址末尾带不带 / 影响动静分离逻辑
这个细节直接决定静态资源路径会不会被错误转发。例如:location /api/ { proxy_pass http://backend; } 和 location /api/ { proxy_pass http://backend/; } 行为完全不同。
- 不带
/:Nginx 把完整 URI(含/api/xxx)原样转发,后端需能处理该前缀 - 带
/:Nginx 会剥离匹配的/api/,只把xxx发过去,适合后端无统一前缀的场景 - 动静分离中,若静态路径(如
/static/)和动态路径(如/api/)共存,必须确保两者location规则互斥且无重叠,否则优先级低的规则会被忽略
最常被忽略的是 MIME 类型识别——Nginx 默认只对常见后缀(.js、.css)返回正确 Content-Type,但像 .webp、.woff2 这类现代格式,若没在 /etc/nginx/mime.types 中声明,浏览器可能拒绝加载或解析异常。别只盯着缓存和代理,先让资源能被正确识别和传输,才是动静分离落地的第一步。


















