Nginx：配置 try_files 实现内部重定向

柔光的暖阳◎ 2023-07-23 04:58 1阅读 0赞

参照官网的文档：[http://nginx.org/en/docs/http/ngx\_http\_core\_module.html\#try\_files][http_nginx.org_en_docs_http_ngx_http_core_module.html_try_files]

Nginx的配置语法灵活，可控制度非常高。

在0.7以后的版本中加入了一个try\_files指令，配合命名location，可以部分替代原本常用的rewrite配置方式，提高解析效率。

### **1、try\_files指令介绍** ###

语法：try\_files file ... uri（格式1） 或 try\_files file ... = code（格式2）

默认值：无

作用域：server location

解释说明：

1.  按指定的file顺序查找存在的文件，并使用第一个找到的文件进行请求处理；
2.  查找路径是按照给定的root或alias为根路径来查找的；
3.  如果给出的file都没有匹配到，则会进行一个内部重定向到最后一个参数给定的uri，就是新的location匹配；
4.  只有最后一个参数可以引起一个内部重定向，之前的参数只设置内部URI的指向；
5.  最后一个参数是回退URI且必须存在，否则会出现内部500错误；
6.  如果是（格式2），若最后一个参数是 = 404 ，若给出的file都没有匹配到，则最后返回404的响应码。

### 2、举例说明 ###

**例1：**

*  root 后面的参数是前端vue项目贷吗安装目录；
 *  try\_files 负责扫描内部目录然后再进行内部重定向；
 *  expires 是nginx控制缓存的一种方式，7d=7天。

> location  /  \{  
>            root   /home/nx/dist;  
>            try\_files $uri $uri/ /index.php?$query\_string  
>            expires 7d;  
>         \}

当用户请求 `http://localhost/example` 时，这里的 `$uri` 就是 `/example`，try\_files 会到硬盘里尝试找这个文件；  
如果存在名为 `/$root/example`（其中 `$root` 是项目代码安装目录）的文件，就直接把这个文件的内容发送给用户；  
显然，目录中没有叫 `example `的文件；  
然后就看 `$uri/`，增加了一个 `/`，也就是看有没有名为 `/$root/example/` 的目录；  
又找不到，就会 fall back 到 try\_files 的最后一个选项 `/index.php`，发起一个内部 “子请求”，也就是相当于 nginx 发起一个 HTTP 请求到 `http://localhost/index.php`。

**例2：**

> location  /  \{  
>            try\_files /app/cache/ $uri @fallback;  
>            index index.php index.html;  
>         \}
> 
> location  @fallback \{  
>           rewrite ^/(.\*)$ http://www.baidu.com        \# 跳转到百度  
>         \}

它将检测$document\_root/app/cache/index.php，$document\_root/app/cache/index.html 和 $document\_root$uri是否存在，如果不存在着内部重定向到 @fallback。

＠表示配置文件中预定义标记点，如上所示（@fallback）。

你也可以使用一个文件或者状态码(=404)作为最后一个参数，如果是最后一个参数是文件，那么这个文件必须存在。

### 3、我遇到的问题 ###

小编通过nginx启动vue以后，我们在访问页面的时候只能访问默认页面和通过项目内跳转其他页面，如果刷新就会404。如图：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDI1OTcyMA_size_16_color_FFFFFF_t_70][]

关于单页面，刷新404问题，如vue + nginx的配置， vue路由必须先加载 index.html 或者XX.js 才能识别到路由，故直接刷新页面会出现404。

这时候最好到做法，是使用try\_files 进行尝试，如果获取不到资源，加载index.html 再利用 rewrite的 last参数，保持路由路径不变，从而实现刷新页面。

**但需要注意：此种解决方法需要 vue和nginx部署在同一台服务器上，这样try\_files才能在服务器硬盘上找到index.html文件**。

原来的nginx配置：

> location / \{  
>            root   /home/vue/dist;  
>            index  index.html index.htm index.jsp;  
>         \}

修改后的nginx配置：

将默认的index注释掉，换成了try\_files，它会去扫描内部目录然后再进行内部重定向，规则上面介绍过了。

> location / \{  
>            root   /home/nx/dist;  
>            \#index  index.html index.htm index.jsp;  
>            try\_files $uri $uri/ /index.html;  
>            expires 7d;  
>         \}

**少侠请留步 ... ヾ(◍°∇°◍)ﾉﾞ ... **  
**欢迎点赞、评论、加关注，让更多人看到学到赚到**  
**更多精彩，请关注我的"今日头条号"：Java云笔记**

[http_nginx.org_en_docs_http_ngx_http_core_module.html_try_files]: http://nginx.org/en/docs/http/ngx_http_core_module.html#try_files
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDI1OTcyMA_size_16_color_FFFFFF_t_70]: /images/20230528/5f40f5afebb34632993734481efe1a0a.png