Web 服务器与网关 / 系统课时

使用 try_files 选择资源

使用 try_files 选择资源

本课学习 Nginx 中用于资源查找的 try_files 指令。通过配置候选路径顺序,可以实现静态文件优先返回、目录检测以及前端单页应用路由回退,让请求准确进入目标资源或应用入口。

学习目标

  • 理解 try_files 的匹配顺序和执行机制
  • 掌握静态资源与 SPA 路由回退配置
  • 能够验证资源不存在时的转发行为

理解 try_files 的工作方式

try_files 会按照配置顺序检查文件或目录是否存在,找到第一个匹配项后停止继续查找。如果所有路径都不存在,则执行最后一个参数指定的处理方式。

它常用于静态站点、前端项目部署和 PHP 等应用入口转发场景,可以减少无效请求进入后端。

配置静态文件查找

下面配置会优先检查请求对应文件,再检查目录,最后返回指定入口。

nginx
server {
    listen 80;
    root /var/www/html;

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

预期结果

text
请求:GET /app.js
存在文件:返回 /var/www/html/app.js

请求:GET /dashboard
不存在文件:内部转到 /index.html

$uri 表示当前请求路径,$uri/ 用于检测目录,最后的 /index.html 是资源不存在时的回退目标。

用于前端路由回退

单页应用通常由前端路由控制页面,例如 /users/100 并不是服务器上的真实文件。如果直接访问该地址,Nginx 可能返回 404。

通过 try_files 将不存在的路径交给入口页面,浏览器加载 JavaScript 后再由前端路由解析。

nginx
location / {
    try_files $uri $uri/ /index.html;
}

预期结果

text
浏览器访问 /users/100
Nginx 查找 /users/100 文件
未找到后返回 index.html
前端应用显示对应页面

转发到应用入口

在动态应用中,try_files 也可以用于判断资源后转交给后端入口。例如 PHP 项目通常需要将不存在的路径交给统一入口文件。

nginx
server {
    root /var/www/app;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }
}

预期结果

text
请求:GET /article?id=10
未找到 article 文件
转发到 /index.php?id=10

实际部署时,需要确保入口文件存在,并根据应用框架要求保留或调整查询参数。

排查 try_files 不生效问题

如果 try_files 行为异常,应优先检查 root 是否正确、location 优先级是否覆盖当前配置,以及目标文件权限是否允许读取。

还需要确认最后参数不是错误路径。Nginx 不会自动创建文件,配置中的路径必须与磁盘实际结构一致。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 try_files 选择资源

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通