try_files是nginx中实现静态资源优先、动态后端兜底的核心指令，按空格分隔顺序检查文件或目录存在性，首个存在即返回，全不存在则内部重写至以/开头的uri或@named位置。
Try_files 是 Nginx 中实现“静态文件优先、回退到动态处理”的核心指令，常用于单页应用（SPA）、PHP 后端或自定义错误页等场景。它的本质是按顺序检查文件或路径是否存在，一旦命中就直接返回，不再继续后续判断。
基本语法与执行逻辑
语法格式为：
try_files file1 file2 ... uri;
说明：
- Nginx 会依次检查 file1、file2 … 是否存在且可读（路径基于
root或alias） - 遇到第一个存在的文件，就用它响应请求（返回 200）
- 若全部不存在，则内部重写请求到末尾的 uri（如
/index.php），并继续匹配 location 块 - 注意：末尾的 uri 必须以
/开头，且不能是真实文件路径
常见实用策略示例
① SPA 路由 fallback（如 Vue/React）
用户访问 /about 时，先查 /about/index.html，再查 /about.html，最后回退到根页面：
location / {
root /var/www/myapp;
try_files $uri $uri/ /index.html;
}
② PHP 动态回退（经典 Laravel/WordPress 配置）
优先服务静态资源（.js/.css/.png），否则交由 index.php 处理路由：
location / {
root /var/www/site;
try_files $uri $uri/ /index.php?$query_string;
}
③ 精确控制静态优先级（带版本号或 hash 的资源）
适配构建工具生成的带哈希名的文件（如 main.a1b2c3.js），同时兼容未带哈希的请求：
location ~ \.js$ {
root /var/www/static;
try_files $uri $uri.gz $uri.br /fallback.js;
}
（支持 gzip/brotli 压缩版本，最后兜底一个 fallback 文件）
关键注意事项
这些细节容易导致行为不符合预期：
-
$uri 是解码后的路径，不包含查询参数；需传参给后端时，用
$query_string拼接 - 使用
try_files的 location 块中，避免再写root和alias冲突；推荐统一在 server 或 location 顶层设root -
try_files末尾的uri触发的是 内部重定向，不会改变浏览器地址栏，也不产生 301/302 - 如果末尾写成一个真实存在的文件（如
/404.html），Nginx 会直接返回该文件内容，但状态码仍是 200 —— 如需 404 状态，应配合error_page
调试技巧
验证是否生效最直接的方式：
- 在配置中临时加日志：
log_not_found off;可关闭“文件未找到”记录，减少干扰 - 用
curl -I http://localhost/xxx查看响应头中的Content-Type和状态码 - 开启 Nginx debug 日志（需编译时启用），或用
nginx -t && nginx -s reload确保配置已加载
