在 nginx 中匹配静态资源后缀,核心做法是使用 `location` 指令配合正则表达式(~)或精确前缀(=),并指定对应的文件扩展名。通过配置 `try_files` 指令,nginx 会优先查找请求路径对应的物理文件,若存在则直接返回,若不存在则回退到默认处理逻辑。这种机制能确保对 `.html`、`.js`、`.css` 等常见静态资源的精准拦截与高效服务。

如何配置 location 以区分不同后缀的静态文件
要区分不同后缀,需为每种类型编写独立的 `location` 块。例如,针对 JavaScript 和 CSS 文件,可以使用正则表达式匹配。当请求 `/app.js` 时,Nginx 会检查该文件是否存在于磁盘上,如果存在则直接读取并发送响应头,否则执行后续的回退逻辑。这种方式允许针对不同后缀设置不同的缓存策略(如 `expires`)或 MIME 类型。

server {
listen 80;
server_name example.com;
root /var/www/html;
# 匹配 .js 文件
location ~* \.js$ {
try_files $uri =404;
expires 30d;
add_header Cache-Control "public, immutable";
}
# 匹配 .css 文件
location ~* \.css$ {
try_files $uri =404;
expires 7d;
}
# 默认 fallback
location / {
try_files $uri $uri/ /index.html;
}
}
上述配置中,`~*` 表示不区分大小写的正则匹配。`try_files $uri =404;` 是关键,它告诉 Nginx 先尝试寻找 `$uri` 指向的文件。如果找到,立即返回;如果没找到,则返回 404 错误。这避免了将静态资源请求错误地转发给后端应用服务器。对于 `.js` 和 `.css`,我们分别设置了不同的过期时间,以适应它们不同的更新频率。
如何处理混合目录下的静态资源与动态路由冲突
当静态资源与动态路由共享同一根目录时,必须确保静态资源的 `location` 优先级高于通用路由。Nginx 会根据 `location` 的定义顺序和类型进行匹配,精确匹配(=)和正则匹配(~)通常具有较高优先级。通过将静态资源匹配放在通用 `location /` 之前,可以防止动态路由规则意外捕获静态文件请求。此外,使用 `try_files` 可以有效解决 SPA(单页应用)中刷新页面导致 404 的问题,同时保证静态资源不被错误重定向。

server {
listen 80;
server_name example.com;
root /var/www/html;
# 静态资源优先匹配
location ~* \.(jpg|jpeg|png|gif|ico|svg)$ {
try_files $uri =404;
expires 1y;
}
# 动态路由 fallback
location / {
try_files $uri $uri/ /index.html;
}
}
在这个例子中,图片资源被单独列出,并设置了较长的缓存时间。通用 `location /` 块中的 `try_files $uri $uri/ /index.html;` 确保了如果请求的路径不是真实文件或目录,就将其重定向到 `index.html`,从而支持前端路由。这种结构清晰地分离了静态资源和动态路由的处理逻辑,避免了冲突。注意,正则匹配的优先级高于前缀匹配,因此即使有 `location /static` 这样的前缀规则,正则规则也会优先生效,除非显式调整顺序或使用更具体的前缀匹配。
基于 try_files 返回 404 时的具体行为是什么
当 `try_files` 找不到指定文件且未提供默认 fallback 时,Nginx 会直接返回 HTTP 404 Not Found 状态码。这意味着客户端收到的是一个标准的 404 响应,而不是由后端应用生成的错误页面。这种行为对于静态资源管理非常有用,因为它可以快速失败,避免不必要的后端调用。开发者可以通过自定义错误页面来改善用户体验,但默认的 404 响应是即时且高效的。











