在 nginx 中配置 404 兜底处理,最直接的方法是在 location 块中使用 try_files 指令,将最后一个参数设置为 =404。这样当所有列出的文件或目录都不存在时,nginx 会立即返回标准的 404 not found 响应,而不会继续尝试匹配其他 location 块或触发内部重定向到自定义错误页(除非配合 error_page 使用)。例如,try_files $uri $uri/ =404; 是单页应用或静态资源服务中最常见的配置模式。

try_files 如何处理 URI 映射与文件查找
该指令按顺序检查提供的参数,直到找到第一个匹配项为止。它首先尝试将请求的 URI 作为文件路径进行查找,如果找不到,则尝试将其视为目录并追加斜杠再次查找。若两者皆未找到,则执行最后指定的动作。这种机制确保了只有当物理路径确实不存在时,才会触发兜底逻辑,避免了无效的内部跳转。

server {
listen 80;
server_name example.com;
root /var/www/html;
location / {
try_files $uri $uri/ =404;
}
}
上述配置中,$uri 代表当前请求的 URI。如果请求 /index.html 且文件存在,直接返回文件内容。如果请求 /api/data 且该文件及目录均不存在,Nginx 将返回 404 状态码。此配置适用于纯静态网站,确保不存在的资源快速失败。
try_files 与 SPA 路由的重定向结合
对于单页应用(SPA),前端路由需要由服务器统一处理。此时,try_files 的最后一个参数不应是 =404,而应指向应用的入口文件,通常是 /index.html。这样,当后端 API 或静态资源缺失时,请求会被内部重定向到 index.html,由前端 JavaScript 接管路由解析,从而避免白屏或 404 错误。

server {
listen 80;
server_name example.com;
root /var/www/html/dist;
location / {
try_files $uri $uri/ /index.html;
}
location /api/ {
proxy_pass http://backend_server;
}
}
在此配置中,try_files $uri $uri/ /index.html; 的逻辑发生了变化。如果请求 /about,服务器先检查是否有 /about 文件或 /about/ 目录。如果都没有,它会将请求内部重定向到 /index.html。注意,这里没有等号,意味着这是一个内部重定向,而非直接返回 404。这对于保持 SPA 的路由功能至关重要,同时 /api/ 位置的配置确保了 API 请求能正确转发到后端服务,不受 try_files 影响。
try_files 返回 404 时的状态码行为
当 try_files 的最后参数以等号开头,如 =404 时,Nginx 会直接设置 HTTP 状态码为 404 并终止处理流程。这与省略最后一个参数或使用 @fallback 不同,后者可能涉及内部重定向或错误页面的渲染。使用 =404 是最明确的“未找到”信号,客户端会收到标准的 404 响应体,通常为空或 Nginx 默认的错误页面内容。这种行为对于 API 服务尤为重要,因为 API 消费者依赖准确的状态码来判断资源是否存在。











