在 nginx 中配置前端路由重定向，核心做法是在 `server` 块内使用 `try_files` 指令将请求指向 `index.html`。具体操作是设置参数为 `$uri $uri/ /index.html`，这样当浏览器访问 `/user/profile` 这类路径时，nginx 会先尝试查找同名文件或目录，若都找不到则回退到 `index.html`，由前端框架接管路由解析。
如何配置 tryfiles 实现 SPA 路由
要实现单页应用（SPA）的路由，需要在 Nginx 配置文件中定位到对应的前端静态资源根目录，并添加 `try_files` 规则。该指令按顺序检查请求的 URI 是否对应真实文件，如果是则直接返回；如果是对应目录，则进入该目录；如果都不是，则强制返回 `/index.html`。这种配置确保了无论用户刷新哪个子页面，服务器都能正确交付入口文件。
server {
listen 80;
server_name example.com;
root /usr/share/nginx/html;
index index.html;
location / {
try_files $uri $uri/ /index.html;
}
}
上述配置中，`root` 指定了静态文件的存放位置。当请求到达时，Nginx 首先检查 `/usr/share/nginx/html` 下是否存在与 `$uri` 匹配的文件。例如请求 `/app.js`，若存在则直接发送该 JS 文件。如果请求的是 `/images/logo.png` 且文件存在，同样直接返回。只有当请求如 `/dashboard` 而目录下没有该文件夹或文件时，才会触发最后的 fallback 机制，返回 `index.html`。
立即学习“前端免费学习笔记（深入）”；
HISUI 前端框架基础开发指南。HISUI 是基于 easyui 二次开发的 jQuery UI 组件库，专为医疗信息系统设计。当涉及 HISUI 组件开发、jQuery easyui 表格/表单/布局/窗口、医疗系统前端页面编写时使用此 skill。 涵盖 40 个组件的官方文档参考，支持声明式与编程式两种初始化方式，提供 $cm/$m 数据访问方法。
tryfiles 的执行逻辑与常见误区
理解 `try_files` 的执行顺序对于排查问题至关重要。它不是简单的“如果失败则重试”，而是按参数列表依次尝试。第一个参数通常是变量，第二个参数可以是目录名或文件路径，最后一个参数必须是内部重定向的目标文件。常见的误区是将最后一个参数写成外部 URL 或错误代码，这会导致语法错误或行为异常。正确的做法是确保最后一步指向一个存在的 HTML 文件。
# 错误的写法示例 try_files $uri $uri/ =404; # 这会返回 404 而不是 index.html try_files $uri $uri/ /index.html; # 正确写法
在实际部署中，开发者常遇到刷新页面后出现 404 错误，这通常是因为缺少了 `try_files` 配置，或者配置的位置不对。如果将 `try_files` 放在 `location ~ \.js$` 这样的特定后缀匹配块中，它将不会生效于 HTML 路由。必须将其放在通用的 `location /` 块中，或者确保其优先级高于其他可能拦截请求的规则。此外，如果前端使用了 Hash 模式路由（如 `#/user`），则不需要此配置，因为浏览器不会将 `#` 后的内容发送给服务器。
基于 /api 接口冲突的具体问题分析
当前端应用同时包含静态资源和 API 请求时，`try_files` 的配置可能会引发接口 404 的问题。这是因为 `try_files` 会将所有未匹配到静态文件的请求都重定向到 `index.html`，包括对 `/api/users` 的请求。如果后端没有配置对应的反向代理，Nginx 就会把 API 请求当成静态资源处理，最终返回 `index.html` 的内容而非 JSON 数据。
location /api/ {
proxy_pass http://backend_server:8080/;
}
location / {
try_files $uri $uri/ /index.html;
}
解决这一问题的方法是为 API 路径单独定义 `location` 块，并利用 Nginx 的匹配优先级。更具体的路径匹配（如 `/api/`）优先级高于通用匹配（`/`）。因此，当请求 `/api/users` 时，Nginx 会优先匹配到 `location /api/` 块，并将其代理给后端服务，从而避开 `try_files` 的重定向逻辑。如果 API 路径与静态资源路径重叠，则需要仔细调整 `location` 的顺序或使用正则表达式进行精确控制。
