「Nginx」- try_files（学习笔记） @20210216

问题描述

该笔记将记录：try_files 的使用方法、常见场景的配置、常见问题的处理。

当请求某个文件时，返回特定的其他文件

location /client/index.php {
	try_files /index.html /index.html;
}

文件存在，但返回 404 状态码

问题描述

对于如下配置，当请求 /foo 地址时，将尝试查找 foo.html 文件，如果不存在则返回 index.html 文件：

location / {
    root /srv/html/;
	try_files $uri.html index.html;
}

虽然 foo.html 不存在，但是 index.html 是存在的，然而却返回 404 状态码。

问题原因

根据 try_files file ... uri; 文档：当文件不存在时，将触发内部重定向到 uri 指定的地址（这里是 index.html 地址）。这是匹配不到的，因为我们没有定义 location index.html，我们应该使用 /index.html，这样能够匹配到 location / 配置。

解决方法

应该使用如下配置：

location / {
    root /srv/html/;
	try_files $uri.html /index.html;
}

或者定义 location index.html 配置：

location index.html {
    # do some stuff
}

参考文献

Module ngx_http_core_module/try_files