Nginx中try_files指令按顺序检查文件存在的配置指南-Nginx-PHP中文网

try_files 按顺序检查路径，首个存在（文件/目录/内部重定向成功）即处理，后续忽略；语法为 try_files file1 file2 ... uri 或 =code；常用于静态兜底、SPA路由、严格404等场景，需注意$uri/含义、alias配合、参数继承及fastcgi配置。

nginx中try_files指令按顺序检查文件存在的配置指南

try_files 是 Nginx 中最常用也最容易出错的指令之一，它的核心逻辑是：**按顺序检查每个指定的路径（或内部 URI），只要有一个存在（或可访问），就立即用它来处理请求，后续项不再检查**。理解“存在”的定义（文件存在、目录存在、内部重定向成功）和执行顺序，是正确配置的关键。

语法格式为：try_files file1 file2 ... uri; 或 try_files file1 file2 ... =code;。Nginx 会从左到右逐个判断：

若 file1 是真实存在的文件（且有读取权限），则直接返回该文件；
若不存在，继续检查 file2 —— 注意：如果 file2 是以 / 开头的路径，Nginx 会在 root 或 alias 指定的根目录下查找；
若所有前面的文件都不存在，最后一项必须是 uri（以 / 开头）或 =code（如 =404），用于内部重定向或返回状态码；
特别注意：uri 不是外部跳转，而是内部发起一次新的 location 匹配，因此可能触发其他 rewrite、proxy_pass 等逻辑。

以下是几种高频场景下的推荐写法：

静态文件兜底 + PHP 后端：
try_files $uri $uri/ /index.php?$query_string;
先找精确匹配的文件，再找同名目录（带尾部斜杠），最后交给 index.php 处理（适合 Laravel、WordPress 等）；
单页应用（SPA）路由支持：
try_files $uri $uri/ /index.html;
确保前端路由（如 /about、/user/123）即使无对应物理文件，也能加载 index.html 由 JS 路由接管；
防止目录遍历 + 显式 404：
try_files $uri =404;
只检查文件是否存在，不尝试目录或 fallback URI，严格限制访问范围；
结合 alias 使用的注意事项：
当 location 使用了 alias，$uri 不会自动拼接 root，需手动补全路径，例如：
location /assets/ { alias /data/static/; try_files $uri /assets/404.png; } —— 这里第二项 /assets/404.png 会被映射为 /data/static/404.png。

这些行为不直观，但直接影响结果：

$uri/ 表示检查是否为有效目录（即存在且可进入），不是简单加斜杠；如果目录存在但无索引文件（如 index.html），Nginx 默认不会自动列出内容，除非启用了 autoindex on；
try_files 必须放在 server 或 location 块中，不能在 if 块内使用（Nginx 会报错）；
最后一项是 uri 时，其查询参数（$args）不会自动继承，需显式携带，例如：/index.php?$query_string 而非 /index.php；
若使用 fastcgi_pass，确保 SCRIPT_FILENAME 等 fastcgi_param 正确设置，否则 PHP 可能报 “No input file specified” —— 这通常不是 try_files 问题，而是后端传递路径错误。

遇到 404 却不确定哪一步失败时，可临时启用日志定位：

在对应 location 中添加：log_not_found off; 关闭默认 404 日志干扰；
开启详细错误日志：error_log /var/log/nginx/debug.log debug;（需编译时含 --with-debug）；
或用 echo 模块（需第三方模块）打印变量，例如：echo "URI: $uri"; echo "Full path: $document_root$uri";；
更轻量的方式：用 curl -I http://your.site/test.js 配合 access_log 查看是否命中静态文件，再对比 curl -I http://your.site/missing 看是否进入 fallback。