排查 nginx try_files 配置顺序导致的重定向死循环，核心在于检查 uri 是否被错误地映射回自身。当 try_files 的最后一个参数（fallback）是一个以 =404 结尾的状态码时，nginx 会执行内部重定向；如果该状态码对应的 location 块再次触发相同的 try_files 逻辑且无法匹配实际文件，就会形成死循环。解决此问题的具体做法是确保 fallback 指向一个明确的静态文件或返回确定的错误码，并避免在递归调用的 location 中重复使用相同的 try_files 规则。
为什么 try_files 的 fallback 会导致内部重定向？
try_files 指令按顺序检查文件是否存在。如果所有列出的文件都不存在，它将使用最后一个参数作为 fallback。如果这个 fallback 是一个以 = 开头的 HTTP 状态码（如 =404），Nginx 不会直接返回错误，而是发起一个内部重定向到该状态码对应的处理流程。如果这个处理流程最终又回到了包含 try_files 的 location，且条件未变，就会陷入死循环。
server {
listen 80;
server_name example.com;
# 错误示范：可能导致死循环
location /app {
try_files $uri $uri/ /app/index.html =404;
}
# 如果 /app/index.html 不存在，Nginx 尝试内部重定向到 =404
# 如果 =404 的处理逻辑再次进入 /app location 且文件仍不存在，则循环
}
在上述配置中，如果 /app/index.html 不存在，Nginx 会尝试内部重定向到 =404。如果此时没有正确的 error_page 处理，或者 error_page 配置不当导致再次进入 /app location，就会发生死循环。关键在于理解 =404 触发的不是直接响应，而是一个内部重定向动作。
如何正确设置 fallback 以避免循环？
要避免死循环，必须确保 try_files 的 fallback 路径不会再次触发相同的检查逻辑。一种常见做法是将 fallback 指向一个具体的、存在的静态文件，或者使用 error_page 明确指定错误处理 location，并确保该 location 不包含会导致递归的 try_files。
server {
listen 80;
server_name example.com;
# 正确示范：使用明确的 error_page
location /app {
try_files $uri $uri/ @fallback;
}
location @fallback {
return 404 "File not found";
}
# 或者，如果希望 SPA 路由正常工作
location /spa {
try_files $uri $uri/ /spa/index.html;
}
}
在第一个示例中，我们使用了命名 location @fallback，它直接返回 404 错误，不再进行任何文件检查，从而打破了潜在的循环。在第二个示例中，fallback 指向 /spa/index.html，这是一个具体的文件路径。如果该文件存在，请求将被服务；如果不存在，Nginx 会继续检查后续的文件（如果有），或者如果没有更多文件可检查，则返回 404。关键是确保 fallback 路径是确定的，并且不会导致回到同一个 try_files 检查点。
当 try_files 指向不存在的 index.html 时会发生什么？
当 try_files 的 fallback 指向一个不存在的 index.html 文件时，Nginx 的行为取决于具体的配置和上下文。如果 fallback 是 /path/to/index.html，且该文件不存在，Nginx 将继续检查列表中的下一个文件（如果有的话）。如果列表中没有更多文件，Nginx 将根据最后一个参数的类型决定行为。如果最后一个参数是 =404，它将触发内部重定向到 404 错误处理。如果最后一个参数是一个文件路径，且该文件也不存在，Nginx 通常会返回 404 错误，但前提是它已经尝试了所有可能的文件路径。
例如，考虑以下配置：
location /test {
try_files $uri $uri/ /test/index.html =404;
}
如果请求 /test/nonexistent，Nginx 首先检查 /test/nonexistent 文件，不存在。然后检查 /test/nonexistent/ 目录，不存在。接着检查 /test/index.html 文件。如果 /test/index.html 存在，请求将被服务。如果 /test/index.html 不存在，Nginx 将触发内部重定向到 =404。如果此时有一个 error_page 404 /custom_404.html; 配置，并且 /custom_404.html 存在，那么用户将被重定向到自定义 404 页面。如果 /custom_404.html 不存在，或者没有配置 error_page，Nginx 将返回标准的 404 错误。关键在于，只要 fallback 路径是确定的，并且不会导致回到同一个 try_files 检查点，就不会发生死循环。
