在 nginx 中配置 vue 或 react 项目防刷新 404,核心做法是在 `location /` 块中使用 `try_files $uri $uri/ /index.html;`。这会让 nginx 优先尝试匹配静态资源文件,若未找到则回退到 `index.html`,从而让前端路由接管后续的路由解析。

Vue Router History 模式下的 try_files 配置
对于使用 Vue Router history 模式的项目,Nginx 需要将所有非静态资源的请求重定向到入口文件。具体做法是确保 `try_files` 指令位于 `root` 指令之后,且路径指向构建后的 `index.html` 所在目录。

server {
listen 80;
server_name example.com;
# 指定构建产物目录
root /var/www/vue-app/dist;
index index.html;
location / {
# 关键配置:先找文件,再找目录,最后回退到 index.html
try_files $uri $uri/ /index.html;
}
# 可选:处理 API 代理
location /api/ {
proxy_pass http://backend-server;
}
}上述配置中,当用户访问 `/about` 时,Nginx 会先在磁盘查找 `/about` 文件,失败后查找 `/about/` 目录,均失败后返回 `/index.html`。Vue Router 读取 URL 中的 `/about` 并渲染对应组件,避免了 404 错误。
立即学习“前端免费学习笔记(深入)”;
KeystoneJS 是一个功能强大的开源无头 CMS,适用于 Node.js,它根据您的模式定义自动生成 GraphQL API 和基于 React 的管理界面。由 Thinkmill 构建,支持 PostgreSQL 和 SQLite、自定义访问控制、钩子、虚拟字段和基于文档的富文本编辑。
React Router v6 的 Hash 与 History 模式差异
React Router 默认使用 Hash 模式(如 `#/home`),此时 Nginx 无需特殊配置,因为 `#` 后的内容不会发送给服务器。但若切换为 History 模式,则需与 Vue 类似配置 `try_files`。区别在于 React 项目通常通过 `create-react-app` 或 Vite 构建,输出结构可能包含 `asset-manifest.json` 等元数据文件,`try_files` 同样能正确处理这些静态文件的缓存与回退逻辑。

// React Router v6 示例代码
import { BrowserRouter, Routes, Route } from 'react-router-dom';
function App() {
return (
<BrowserRouter>
<Routes>
<Route path="/" element={<Home />} />
<Route path="/dashboard" element={<Dashboard />} />
</Routes>
</BrowserRouter>
);
}当启用 `
try_files 中 /index.html 前斜杠的作用
在 `try_files $uri $uri/ /index.html;` 中,`/index.html` 前的斜杠表示这是一个内部重定向(internal redirect),而非外部跳转。若省略斜杠写成 `try_files $uri $uri/ index.html;`,Nginx 会将其视为相对路径,可能导致路径解析错误或权限问题。加上斜杠后,Nginx 会在当前 `root` 目录下查找 `index.html`,并确保最终返回的是正确的 HTML 文档,同时保持浏览器地址栏 URL 不变,避免触发新的 HTTP 请求导致循环或 404。

















