try_files 按顺序检查路径，首个存在（文件/目录/内部重定向成功）即处理，后续忽略；语法为 try_files file1 file2 ... uri 或 =code；常用于静态兜底、SPA路由、严格404等场景，需注意$uri/含义、alias配合、参数继承及fastcgi配置。
try_files 是 Nginx 中最常用也最容易出错的指令之一，它的核心逻辑是：**按顺序检查每个指定的路径（或内部 URI），只要有一个存在（或可访问），就立即用它来处理请求，后续项不再检查**。理解“存在”的定义（文件存在、目录存在、内部重定向成功）和执行顺序，是正确配置的关键。
try_files 的基本语法与匹配规则
语法格式为：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。
