在 nginx 中配置回退到错误页面,最直接的方法是在 location 块中使用 try_files 指令,将最后一个参数设置为内部重定向路径(以 @ 开头)或具体的静态文件路径。当所有列出的物理文件都不存在时,nginx 会执行最后指定的动作,从而实现优雅地展示自定义 404 或其他错误页面。

如何配置 try_files 指向自定义 404 页面
要让 try_files 回退到自定义的 404 页面,需要将最后一个参数设为一个内部重定向标签,例如 @error404,并在服务器块中定义对应的 location @error404。这样,当请求的文件不存在时,Nginx 不会直接返回默认的 404 响应,而是内部跳转到指定位置处理。

server {
listen 80;
server_name example.com;
root /var/www/html;
location / {
# 尝试查找文件,如果都不存在,则内部重定向到 @error404
try_files $uri $uri/ @error404;
}
location @error404 {
# 返回 404 状态码并显示自定义页面
return 404 /custom_404.html;
}
# 确保自定义页面本身能被访问(通常不需要额外配置,因为 root 已设置)
}
在上述配置中,$uri 代表请求的 URI,$uri/ 代表目录。如果两者都不是有效的文件或目录,请求将被传递给 @error404。在 @error404 中,我们使用 return 404 /custom_404.html;。注意,这里的路径是相对于 root 的。Nginx 会读取 /var/www/html/custom_404.html 并将其内容作为响应体返回,同时状态码为 404。
如何配置 try_files 回退到默认首页或特定文件
除了回退到错误页面,try_files 也常用于单页应用(SPA)的回退,或者当文件不存在时提供默认内容。此时,最后一个参数可以是另一个文件名,如 /index.html 或 /fallback.png。Nginx 会直接尝试读取该文件并返回其内容,状态码通常为 200(除非后续逻辑改变)。

server {
listen 80;
server_name example.com;
root /var/www/html;
location / {
# 尝试精确匹配文件,再尝试目录,最后回退到 index.html
try_files $uri $uri/ /index.html;
}
# 对于 SPA,通常不需要额外的 location,因为 /index.html 会被正常 serving
}
在这个例子中,如果用户访问 /nonexistent,Nginx 首先检查 /var/www/html/nonexistent,然后检查 /var/www/html/nonexistent/。如果都不存在,它会将请求内部重定向到 /index.html。这意味着浏览器地址栏仍显示 /nonexistent,但内容是 index.html 的内容,状态码为 200。这对于 React 或 Vue 等前端路由非常有用,因为它们需要在客户端处理路由。
当 try_files 找不到任何文件且未指定回退时会发生什么
如果在 try_files 指令中没有指定最后一个参数,或者最后一个参数是一个不存在的文件路径且没有内部重定向,Nginx 的行为取决于具体配置。但标准做法是必须指定至少一个回退项。如果省略最后一个参数,Nginx 会返回 404 Not Found 错误,并使用默认的 Nginx 错误页面(如果存在)或生成一个简单的错误响应。然而,更常见的情况是,如果最后一个参数指向一个不存在的文件,Nginx 会尝试读取它,如果失败,则返回 404。因此,明确指定回退路径是关键。











