在 nginx 中，`try_files` 配合 `error_page` 优化容灾的核心做法是：利用 `try_files` 按优先级尝试多个文件路径，当所有路径均不存在时触发 404 错误，再通过 `error_page` 将 404 指向一个静态的降级页面或后端健康检查接口。这样可以在主资源缺失或后端服务不可用时，快速返回友好的错误提示或备用内容，避免直接暴露原始错误信息，提升用户体验和系统容错能力。
如何配置 try_files 实现多级回退
要实现多级回退，需要在 `location` 块中使用 `try_files` 指令，依次列出希望 Nginx 尝试的文件路径。如果前一个路径存在，则直接返回；如果都不存在，则将最后一个参数作为内部重定向的目标。通常最后一个参数是一个 URI，用于触发特定的错误处理逻辑。例如，先尝试精确匹配的文件，再尝试目录索引，最后指向一个默认的错误页面。
server {
listen 80;
server_name example.com;
root /var/www/html;
location / {
# 先尝试精确匹配的文件
# 再尝试以该路径为前缀的目录（如 /index.html）
# 如果都失败，内部重定向到 /fallback.html
try_files $uri $uri/ /fallback.html;
}
# 定义 fallback.html 的处理方式
location = /fallback.html {
internal; # 防止外部直接访问
try_files /static/fallback.html =404;
}
}
上述配置中，当用户访问 `/nonexistent` 时，Nginx 会先查找 `/var/www/html/nonexistent`，若不存在则查找 `/var/www/html/nonexistent/index.html`，若仍不存在，则内部重定向到 `/fallback.html`。最终由 `/fallback.html` 位置块提供实际的降级页面内容。这种结构确保了无论前端资源如何变化，都有一个稳定的后备方案。
如何结合 error_page 处理后端故障
当 `try_files` 无法解决动态内容或 API 调用失败的问题时，可以结合 `error_page` 指令来处理后端服务不可用的情况。通过设置 `error_page` 捕获特定 HTTP 状态码（如 502、503、504），并将其重定向到一个静态的错误页面或另一个健康的后端节点。这样可以避免用户看到原始的服务器错误信息，而是看到一个经过设计的友好提示。
upstream backend {
server 192.168.1.10:8080;
server 192.168.1.11:8080 backup;
}
server {
listen 80;
server_name api.example.com;
location /api/ {
proxy_pass http://backend;
# 当后端返回 502、503 或 504 时，重定向到 /maintenance.html
error_page 502 503 504 /maintenance.html;
location = /maintenance.html {
root /var/www/html;
internal;
}
}
}
在这个配置中，当上游后端服务器返回 502、503 或 504 错误时，Nginx 会将请求内部重定向到 `/maintenance.html`。这个页面可以是静态的 HTML 文件，告知用户服务暂时不可用。这种方式不仅提升了用户体验，还避免了因后端故障导致的频繁重试和资源浪费。同时，`internal` 指令确保 `/maintenance.html` 只能被内部重定向访问，防止外部直接请求该路径。
当 try_files 找不到任何文件时会发生什么
当 `try_files` 列出的所有路径都不存在，且最后一个参数不是有效的 URI 或文件时，Nginx 会根据配置的 `error_page` 或直接返回 404 错误。如果最后一个参数是一个内部重定向的目标，但该目标也不存在，则会继续向上层错误处理机制传递，直到找到合适的错误页面或最终返回 404。因此，确保 `try_files` 的最后一个参数始终指向一个存在的资源或有效的错误处理逻辑至关重要。
