Nginx中try_files指令优先级高于index指令,一旦配置try_files,index将被完全忽略;仅当未配置try_files时,index才对以/结尾的目录请求生效,按顺序查找指定索引文件。

在 Nginx 中,index 指令和 try_files 指令**不会同时生效**,它们的执行逻辑存在明确的优先级:如果配置了 try_files,Nginx 就**完全跳过 index 指令**,不再自动处理目录索引;反之,若未配置 try_files,且请求的是一个目录路径(如 / 或 /blog/),Nginx 才会按 index 指令指定的文件列表依次查找并返回第一个存在的文件。
index 指令只在无 try_files 时起作用
index 是一种“隐式默认行为”,仅用于处理以 / 结尾的目录请求。例如:
- 请求
GET /→ Nginx 查找index.html、index.htm(按配置顺序)→ 返回首个存在的文件 - 该过程发生在
location匹配后、内容处理前,但前提是该location中未定义try_files - 一旦配置了
try_files,无论请求是否为目录,Nginx 都严格按try_files的参数逐项检查,index被彻底忽略
try_files 指令接管全部文件试探逻辑
try_files 是显式、可控的文件(或 URI)匹配机制,它按从左到右顺序检查每一项:
- 遇到存在的文件(如
$uri对应真实文件),直接返回该文件 - 遇到存在的目录(如
$uri/),Nginx 不会自动触发 index 指令,而是继续检查下一项(除非你显式写成$uri/ =404或$uri/ index.html) - 最后一项可以是内部 URI(如
@fallback)或 HTTP 状态码(如=404)
常见正确用法示例(支持目录索引):
location / {
try_files $uri $uri/ /index.html;
}
这里 $uri/ 表示“把请求路径当目录看待”,若该目录存在,Nginx 就会尝试访问它 —— 但注意:此时仍需配合 index 指令才能返回其中的 index.html。然而,由于 try_files 已启用,index 不再自动生效。所以更稳妥的做法是:把索引文件显式写进 try_files 的最后备选项中,例如:
location / {
try_files $uri $uri/ /index.html;
}
这样即使 / 是个目录,Nginx 也会在找不到 $uri 文件、又发现 $uri/ 是目录后,最终回退到 /index.html(由 root 或 alias 定义的路径下)。
实际配置中的关键细节
-
try_files必须出现在location块中,且每个location可独立配置;index可在http、server、location级设置,但会被更内层的配置覆盖 -
try_files $uri $uri/;这种写法对目录请求无效 —— 因为$uri/匹配成功后,Nginx 会尝试访问该目录,但没有后续动作(不自动查 index),结果通常是 403(禁止列目录)或 404(若目录无 index 且未开启 autoindex) - 若希望保留传统 index 行为,又想用 try_files 做前端路由(如 SPA),应避免依赖
index,而统一用try_files $uri $uri/ /index.html;
不复杂但容易忽略:Nginx 的文件查找是单向、短路的,try_files 一出现,index 就退场。真正决定“哪个文件被返回”的,永远是 try_files 列表中第一个命中的项。

















