现象想给静态资源加缓存于是写了这样一段 Nginx 配置location /{proxy_cache my_cache;proxy_pass http://dashboard_cluster;location /api/{proxy_cache off;proxy_pass http://dashboard_cluster;}}重启 Nginx访问首页正常访问 /api/health 直接 404。排查先看错误日志sudotail-20/var/log/nginx/error.log没报错。再看访问日志请求确实进来了Nginx 返回 404。折腾了十几分钟搜到一条回答Nginx 的 location 不能嵌套。上面那种写法内层的 location /api/ 被 Nginx 完全忽略了。所有请求都被外层 location / 处理而外层规则不匹配 /api/ 前缀返回 404。原因Nginx 的 location 是平铺的没有嵌套概念。匹配优先级精确匹配 location /path最高前缀匹配 location ^~ /path正则匹配 location ~ .php$普通前缀匹配 location /path兜底 location /规则是前缀越长的优先匹配。所以 /api/ 比 / 优先级高。正确写法两个 location 平级# API不缓存location /api/{proxy_pass http://dashboard_cluster;proxy_set_header Host$host;add_header Cache-Controlno-cache, no-store, must-revalidate;}# 其他开缓存location /{proxy_cache my_cache;proxy_cache_valid20030210s;add_header X-Cache-Status$upstream_cache_status;proxy_pass http://dashboard_cluster;proxy_set_header Host$host;}怎么验证缓存生效浏览器 F12 → Network → 刷新两次 → 看响应头第一次X-Cache-Status: MISS第二次X-Cache-Status: HIT ← 缓存命中了三个坑坑 1Nginx 的 location 不能嵌套。写了嵌套也不会报错只会静默忽略内层规则很难发现。坑 2location / 是兜底规则会捕获所有没被其他规则匹配的请求。如果把 /api/ 写在它里面等于白写。坑 3给 API 开缓存是大忌。API 返回实时数据缓存了用户看到的就是旧数据。按业务类型区分缓存策略数据敏感的API不缓存展示型的页面可以缓存。
